sqry - Semantic Code Search

sqry MCP サーバー

バージョン: 33.0.1

MCP レジストリ名: mcp-name: io.github.verivus-oss/sqry

sqry-mcp は、sqry のセマンティックコード検索ツールを Model Context Protocol クライアントに公開します。

モード

スタンドアロンモード:

sqry-mcp --no-daemon

デーモンバックエンドモード:

sqry daemon start
sqry daemon load .
sqry-mcp --daemon

スタンドアロンモードでは現在 39 個のツールを公開しています。デーモンホスト型 MCP では、sqryd に支えられた 17 個のツールのサブセットを公開しています。正確なスキーマと説明を取得するには、動的ディスカバリを使用してください:

sqry-mcp --list-tools

MCP クライアントは tools/list を呼び出すこともでき、sqry クライアントは sqry://meta/manifest を読み取ることができます。

21.0.0 で削除: 自然言語 MCP ツール sqry_ask は削除されました。代わりに sqry_query、semantic_search、relation_query を使用してください。移行については削除された機能を参照してください。

セットアップ

sqry mcp setup --tool claude
sqry mcp setup --tool codex
sqry mcp setup --tool gemini

書き込まずにプレビュー:

sqry mcp setup --tool codex --dry-run

Codex と Gemini はグローバルな MCP 設定を使用し、対象プロジェクトでアシスタントを起動することに依存しています。Claude のプロジェクトスコープでは、ワークスペースルートを固定できます。

セットアップがスタンドアロンのコマンドを書き込む場合、--no-daemon を想定してください。--daemon は、意図的に sqryd を起動して読み込んだ場合にのみ使用してください。

ツールのディスカバリ

静的な表をコピーするよりも、ディスカバリを優先してください:

• MCP tools/list
• sqry-mcp --list-tools
• sqry://meta/manifest
• sqry://docs/tool-guide
• sqry://docs/capability-map

スタンドアロンのカタログには、シンボル検索、ナビゲーション、リレーションクエリ、グラフエクスポート、影響分析、セマンティック差分、重複/循環/未使用の検出、ワークスペースステータス、コンテキスト伝播のためのツールが含まれています。

クイックスタートのツール呼び出し

文字列述語には query を、構造化された JSON の事前フィルターには filters を使用してください:

{
  "name": "semantic_search",
  "arguments": {
    "query": "kind:function items:true",
    "filters": {
      "language": ["rust"],
      "visibility": "public"
    }
  }
}

定義のみの述語には、query 内で items:true または is_definition:true を使用してください。list_symbols では、代わりに構造化された items_only パラメーターを使用してください:

{
  "name": "list_symbols",
  "arguments": {
    "kind": "function",
    "language": "rust",
    "items_only": true
  }
}

信頼できる定義シグナルを持たない V16 以前のスナップショットでは、これらの定義専用のサーフェスは、古いデフォルト false のマーカーデータを暗黙的に評価するのではなく、reindexRequired / 再インデックス必須の勧告を返します。

ワークスペース

MCP は、明示的なパス、ファイルを含む引数、MCP ルート、最近のセッションコンテキスト、および現在の作業ディレクトリへのフォールバックから、ワークスペースコンテキストを解決します。

マルチルートプロジェクトでは、.sqry-workspace、または sqry.workspace を含む VS Code の .code-workspace ファイルでワークスペースを設定してください。

sqry workspace status . --json

source_root_id

workspace_status.aggregate.source_root_statuses[].source_root_id は、不透明な 8 桁の 16 進数の表示/相関トークンです。これはパスではなく、パスプレフィックスでもありません。

無効なツールパス:

485f1995/src/lib.rs

有効なツールパス:

src/lib.rs
/absolute/path/to/workspace/src/lib.rs

リダクション下では、結果のパスは表示用にソースルートプレフィックス付きでレンダリングされることがあります。source_root_id は、その表示プレフィックスを集約ステータスエントリと相関させるためにのみ使用してください。クリアテキストのソースルートは、選択されたリダクションプリセットが許可する場合にのみ、トップレベルの source_roots[] に現れます。

リダクション

MCP ランタイムのデフォルトは minimal です。ホスト型または外部の LLM プロバイダーには、より厳格なパスプライバシーが必要でない限り、standard が推奨プリセットです。より強力なリダクションには strict が利用可能です。

これらは別々に扱ってください:

• ランタイムのデフォルト: minimal
• 推奨される外部プロバイダープリセット: standard
• ライブラリ/環境のデフォルト: 埋め込み固有の動作については sqry-mcp-redaction のドキュメントを参照してください

関連ガイド

• 公開 MCP ガイド
• ワークスペースガイド
• デーモンガイド
• トラブルシューティング