Codebase Retrieval (RepoMix)

🚀 コードベースモデルコンテキストプロトコル (MCP) サーバー

Model Context Protocol (MCP) サーバーの実装であり、RepoMix を使用してコードベース全体を検索および分析するためのツールを提供します。

この MCP を使用すると、Cursor の Composer Agent などの AI エージェントが一度にコードベース全体を自動的に読み取り、理解することができます。これにより、開発者は大規模なコードベースをより簡単に扱うことができ、AI アシスタントはプロジェクトの全体的なコンテキストを把握することができます。

✨ 主な機能

• 📚 コードベース検索：XML、Markdown、Plain などのさまざまな形式で、コードベース全体を単一のテキスト出力として検索します。
• 🌐 リモートリポジトリサポート：リモートの GitHub リポジトリを直接処理できます。
• 💾 ファイル保存：処理されたコードベースをファイルに保存できます。
• 🔧 カスタマイズ可能なオプション：コメント、行番号、ファイルの要約など、コードベースの処理方法をさまざまなオプションで制御できます。

📦 インストール

NPM からのインストール（推奨）

# グローバルにパッケージをインストール
npm install -g codebase-mcp

# RepoMix（必須の依存関係）をインストール
codebase-mcp install

GitHub からのインストール

# リポジトリをクローン
git clone https://github.com/DeDeveloper23/codebase-mcp.git

# プロジェクトディレクトリに移動
cd codebase-mcp

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

# グローバルにインストール
npm install -g .

# RepoMix（必須の依存関係）をインストール
codebase-mcp install

💻 Cursor との統合

この MCP を Cursor の Composer Agent と一緒に使用するには、以下の手順を実行します。

1. Cursor IDE を開きます。
2. サイドバーの Composer アイコンをクリックします。
3. 上部の「MCP サーバー」ボタンをクリックします。
4. 「新しい MCP サーバーを追加」をクリックします。
5. 詳細を入力します。
   • 名前：Codebase MCP（または任意の好きな名前）
   • タイプ：command
   • コマンド：codebase-mcp start
6. 「追加」をクリックして保存します。

追加されると、MCP は Composer Agent に 3 つの強力なツールを提供します。

利用可能なツール

1. getCodebase
   • 目的：現在のワークスペース/プロジェクトを分析します。
   • 使用方法：AI がコードベース全体を理解する必要がある場合に使用します。
   • 例のプロンプト：「コードベースの構造を理解するために、分析してください」
2. getRemoteCodebase
   • 目的：任意のパブリック GitHub リポジトリを取得して分析します。
   • 使用方法：他のプロジェクトを探索または理解したい場合に使用します。
   • 例のプロンプト：「github.com/username/repo を調べて、彼らのテストフレームワークがどのように機能するかを説明できますか？」
3. saveCodebase
   • 目的：コードベースの分析結果をファイルに保存し、後で使用できるようにします。
   • 使用方法：コードベースのスナップショットを保存または共有したい場合に使用します。
   • 例のプロンプト：「このコードベースの分析結果を 'codebase-analysis.md' として Markdown 形式で保存してください。」

Cursor での使用例

以下は、Composer Agent と一緒に使用できる例のプロンプトです。

「現在のプロジェクトを分析し、主要なコンポーネントを説明してください。」

「tensorflow/tensorflow リポジトリを調べて、彼らのテストフレームワークがどのように機能するかを説明できますか？」

「このコードベースの分析結果を 'codebase-analysis.md' として保存し、後で確認できるようにしてください。」

Composer Agent は自動的にあなたのリクエストに応じて適切なツールを使用します。

💻 Cursor 外部での使用

MCP サーバーの起動

codebase-mcp start

これにより、MCP サーバーが stdio モードで起動し、任意の MCP 互換クライアントから使用できます。

📄 ライセンス

MIT