Code Search MCP

🚀 コード検索MCPサーバー

AIエージェント向けの高性能、バッチ指向のMCP（モデルコンテキストプロトコル）コード理解ツールキットで、特にJava用に最適化されています。

このツールキットは、AIエージェントが大規模なコードベースで「迷子」になったり、正確なコンテキストを欠いたりする問題を解決するために設計されています。深い解析、並列バッチ処理、パノラマコンテキストに焦点を当て、大規模なコードベースを効率的に探索し、トークンの使用量を大幅に削減しながら、論理的な理解を向上させます。

🚀 クイックスタート

コード検索MCPサーバーは、AIエージェントが大規模なコードベースを効率的に理解するためのツールキットです。以下の手順でセットアップして使用することができます。

✨ 主な機能

• パノラマコンテキスト：依存関係のコンテキストを自動的に展開し、一度の呼び出しで複数のファイルを読み取ります。
• 構造マッピング：深いJavaアノテーションの認識を持ち、プロジェクトのアウトラインを迅速に構築します。
• 精密な操作：クラス、メソッド、定義を正確に特定し、バッチで返します。

📦 インストール

必要条件

• Node.js v18.0.0 以上

インストールとビルド

npm install
npm run build

💻 使用例

基本的な使用法

統合設定

"mcpServers": {
  "code-search": {
    "command": "node",
    "args": ["{file}/code-search/index.js"]
  }
}

高度な使用法

• パノラマコンテキストの取得：view_files_full_context を使用して、一度の呼び出しで完全なコンテキストを取得します。
• 構造アウトラインの抽出：view_files_outlines を使用して、Javaアノテーションを考慮したバッチアウトラインを抽出します。
• クラスやメソッドの特定：view_code_items を使用して、クラス、メソッド、定義を正確に特定します。

📚 ドキュメント

コアツール

設計上の注意事項

• 標準入出力トランスポート：標準入出力を介したJSON-RPC 2.0。
• 決定論的なプロトコル：絶対パスのみを使用し、パスのワイルドカードは使用しません。
• Javaアウトラインの強化：アノテーションの逆追跡をシグネチャに統合します。

Java Springの深い適合

このツールキットは、単なるテキスト検索ではなく、ビジネスロジックを理解します。

• レイヤー認識順序：（Controller → Service → Impl → MQ → Repository）の順にインテリジェントにソートし、AIがビジネスフローをすぐに理解できるようにします。
• 深いアノテーション認識：シグネチャだけでなく、@Transactional、@PreAuthorize などの統合されたアノテーションをAIが見ることで、ビジネスセマンティクスを理解します。
• スマートな依存性注入解析：自動的に注入されたフィールド（依存関係）を識別し、AIが userService の由来を推測する必要をなくします。
• プロジェクト構造：src/main/java とマルチモジュールのMaven/Gradleプロジェクトを完全にサポートします。

使用上のヒント

⚠️ 重要提示

• 安定性と再現性のために、絶対パスを使用してください。
• 複雑なクエリは、精密な呼び出しに分割することをお勧めします。

💡 使用建议

一度の呼び出しで完全なコンテキストを取得する場合は、view_files_full_context を使用することをおすすめします。

📄 ライセンス

このプロジェクトはMITライセンスの下でオープンソース化されています。ライセンスの条件に従って、使用、変更、配布することができます。