Codebase MCP

🚀 コードベース MCP

モデルコンテキストプロトコル (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 サーバーが起動し、互換性のある任意の MCP クライアントで使用できます。

📄 ライセンス

MIT