Code Index MCP

🚀 コードインデックス MCP

コードインデックス、検索、分析を行うためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用することで、大型言語モデルがコードリポジトリと相互作用し、コードベース内の洞察やナビゲーション機能をリアルタイムで提供できます。

🚀 クイックスタート

コードインデックス MCP は、MCP プロトコルに特化したサーバーで、高度なコードインデックスと分析機能を提供します。このサーバーは、AI モデルが外部ツールやデータソースと相互作用するための標準的な方法である モデルコンテキストプロトコル（MCP）に統合されています。

✨ 主な機能

• プロジェクトインデックス：ディレクトリを再帰的にスキャンし、検索可能なコードファイルのインデックスを構築します。
• コード検索：コードベース内でパターン、関数定義、参照を検索します。
• ファイル分析：ファイル構造、インポート、複雑度などの詳細情報を取得します。
• スマートフィルタリング：ビルドディレクトリ、依存関係、非コードファイルを自動的に無視します。
• 永続的なストレージ：インデックスをキャッシュし、セッション間でのパフォーマンスを向上させます。

📦 インストール

前提条件

• Python 3.8 以上
• uv パッケージマネージャー（推奨）

uvx を使用する（推奨）

uvx を使用すると、コードインデックス MCP を簡単にインストールして実行できます。

uvx code-index-mcp

pip を使用する

または、pip を使用してインストールすることもできます。

pip install code-index-mcp

インストール後、モジュールとして実行できます。

python -m code_index_mcp

💻 使用例

基本的な使用法

Claude Desktop との統合

以下の内容を Claude の設定ファイル（~/Library/Application Support/Claude/setting.json）に追加します。

{
  "codeIndexMCP": {
    "enabled": true,
    "path": "/usr/local/bin/uvx"
  }
}

高度な使用法

利用可能なツール

• プロジェクトパスの設定：インデックスを作成するプロジェクトのルートディレクトリを指定します。
• コードの検索：プロジェクト内で特定のコードパターンや関数を検索します。
• ファイルの分析：ファイルの関連メタデータと構造情報を取得します。
• 結果のフィルタリング：必要に応じてインデックス結果をフィルタリングします。
• キャッシュ管理：インデックスを維持および更新し、効率的なパフォーマンスを維持します。

📚 ドキュメント

サポートされるファイルタイプ

サーバーは、以下のような複数のプログラミング言語とファイル拡張子をサポートしています。

• Python (.py)
• JavaScript/TypeScript (.js, .ts, .jsx, .tsx)
• Java (.java)
• C/C++ (.c, .cpp, .h, .hpp)
• C# (.cs)
• Go (.go)
• Ruby (.rb)
• PHP (.php)
• Swift (.swift)
• Kotlin (.kt)
• Rust (.rs)
• Scala (.scala)
• Shell スクリプト (.sh, .bash)
• Web ファイル (.html, .css, .scss)
• ドキュメント/設定ファイル (.md, .json, .xml, .yml, .yaml)

開発

このプロジェクトに貢献するには、開発者ドキュメント を参照してください。

言語

• 繁體中文

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE を参照してください。