johnhuang316/code-index-mcp

解決する課題

Code Index MCP は、AIアシスタントが複雑で多言語のコードベースを理解・ナビゲートする困難さを解決します。LLMがすべてのファイルを手動で読む必要なく、コードのシンボルやファイル構造をインデックス化・検索・分析する構造的な方法を提供します。

動作方法

Model Context Protocol (MCP) サーバーとして動作し、AIモデルとローカルファイルシステムを橋渡しします。インデックス作成には二段階戦略を採用しています：

• Tree-sitter ASTパース：Python、TS、Rust、Goなどを含む10言語のネイティブ構文解析を提供し、クラス、メソッド、呼び出し関係を抽出します。
• フォールバック戦略：50以上の他のファイルタイプに対して基本的なインデックス作成を提供します。

サーバーにはリアルタイムのインデックス更新を可能にするファイルウォッチャーが内蔵されており、ripgrep や ugrep などのネイティブ検索ツールと統合されて、高度な正規表現やファズィ検索が可能になります。

対象ユーザー

MCP互換のAIアシスタント（例：Claude Desktop）を使用している開発者で、大規模プロジェクトのコードレビュー、リファクタリング、デバッグ、アーキテクチャ解析に役立つツールが必要な方々に最適です。

特徴

• 多言語対応：10言語の専用ASTパースと、50以上のファイルタイプへの基本対応。
• リアルタイム監視：ネイティブOSのファイルウォッチャーによる自動インデックス更新。
• 深層分析：深層インデックスを活用したシンボルレベルのメタデータおよび複雑度メトリクスの生成。
• 柔軟な検索：リテラル検索、正規表現、ファズィマッチをサポートし、ページネーション付きの結果を返します。
• 永続的キャッシュ：インデックスをローカルに保存し、再アクセス時に高速な読み込みを実現。