Skip to content

v3.12.0

Choose a tag to compare

View all tags
@rex0220 rex0220 released this 21 Jul 14:05
v3.12.0
2b6285b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

B55: MCP read-only ドキュメントツール ksql_docs＋全量関数カタログ instructions

MCP resources / prompts を中継しないクライアント経路（Claude Desktop のリモート接続プロキシで実測）では、v3.9.0 で公開した言語リファレンス resource（ksql://language-reference）に到達できず、AI が ksql_validate 総当たりで不完全な関数一覧を推定する事態が発生していました。本リリースで、どのクライアントでも届く tool 経由の導線を追加します。

機能追加

  • ksql_docs（新 read-only ツール）: 引数なし=言語リファレンス・レシピの統合インデックス（全 40 キー）。section 指定=resource と同一キー語彙（language-reference/<26 章キー>・recipes/r1..r12・ksql:// URI 形も受理）で 1 章の markdown を返す。固定 map lookup のみで kintone API・資格情報に不触。未知キーは有効キー案内付き ArgumentError（fail-closed）。
  • server instructions に全量関数カタログを掲載（scalar 43・aggregate 6・window 3・contextual 3・alias 5・syntax）。「関数の有無を validate の試行錯誤で推定しない」導線を明示し、ksql_validate / ksql_query / ksql_mutate の説明にも ksql_docs を追記。カタログはパーサ実受理集合との双方向ドリフトガードで固定。
  • 言語リファレンス §5 に SUBSTR とエイリアス対応（SUBSTR→SUBSTRING・CONVERT→CAST・CEILING→CEIL・TRUNC→TRUNCATE・POW→POWER）を追記。

互換性

  • プラグイン・CLI の SQL 実行挙動に変更なし（SemVer: minor）。既存 MCP resources は不変のまま並存。

検証

  • 全 2,729 テスト green・mcp:smoke / pack-smoke / mcpb-verify ok
  • 実機: 発端の resources 非対応経路（Claude Desktop）でプローブ抑止＋全量関数回答を確認（docs/internal/evidence/b55_claude_desktop_smoke.md）

🤖 Generated with Claude Code

Assets 5
Loading