モデルコンテキストプロトコル(MCP)サーバーの実装で、RepoMix を使用して、コードベース全体を取得および解析するためのツールを提供します。

この MCP は、Cursor の Composer Agent のような AI エージェントが、一度にコードベース全体を自動読み取り、理解できるようにします。これにより、開発者が大規模なコードベースやAI アシスタントと連携し、プロジェクトの包括的なコンテキストを持つことが容易になります。

##特徴

• ✓Codebase Retrieval**:コードベース全体を異なるフォーマットで出力する単一のテキストとして取得します(XML、Markdown、 Plain)
• バックアップ リモートリポジトリサポート:直接リモートGitHubリポジトリを処理する
• 💾ファイル保存:処理されたコードベースをファイルに保存する
• ☑カスタマイズ可能なオプション: コードベースがさまざまなオプション(コメント、行番号、ファイルの要約など)で処理される方法を制御する

インストール

##NPM から (推奨)

###GitHubから

Cursor との ## 統合

CursorのComposer AgentでこのMCPを使用するには:

1. 開いたカーソルのIDE
2. サイドバーのコンポーザーアイコンをクリックします
3. 「MCP Servers」ボタンをクリック
4. 「新規MCPサーバーを追加」をクリック
5. 細部で満たして下さい:

• 名前: Codebase MCP (またはあなたが好む名前)
• タイプ: [command
• コマンド: [codebase-mcp start

Codebase MCP

A Model Context Protocol (MCP) server implementation that provides tools to retrieve and analyze entire codebases using RepoMix.

This MCP allows AI Agents like Cursor’s Composer Agent to automatically read and understand entire codebases at once, making it easier for developers to work with large codebases and for AI assistants to have comprehensive context of a project.

Features

• 📚 Codebase Retrieval: Retrieve the entire codebase as a single text output in different formats (XML, Markdown, Plain)
• 🌐 Remote Repository Support: Process remote GitHub repositories directly
• 💾 File Saving: Save the processed codebase to a file
• 🔧 Customizable Options: Control how the codebase is processed with various options (comments, line numbers, file summaries, etc.)

Installation

From NPM (Recommended)

# Install the package globally
npm install -g codebase-mcp

# Install RepoMix (required dependency)
codebase-mcp install

From GitHub

# Clone the repository
git clone https://github.com/DeDeveloper23/codebase-mcp.git

# Navigate to the project directory
cd codebase-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Install globally
npm install -g .

# Install RepoMix (required dependency)
codebase-mcp install

Integration with Cursor

To use this MCP with Cursor’s Composer Agent:

1. Open Cursor IDE
2. Click the Composer icon in the sidebar
3. Click the “MCP Servers” button at the top
4. Click “Add new MCP server”
5. Fill in the details:
   • Name: Codebase MCP (or any name you prefer)
   • Type: command
   • Command: codebase-mcp start
6. Click “Add” to save

Once added, the MCP will provide three powerful tools to the Composer Agent:

Available Tools

1. getCodebase

   • Purpose: Analyzes your current workspace/project
   • Use when: You want the AI to understand your entire codebase
   • Example prompt: “Please analyze my codebase to understand its structure”

2. getRemoteCodebase

   • Purpose: Fetches and analyzes any public GitHub repository
   • Use when: You want to explore or understand other projects
   • Example prompt: “Can you analyze the repository at github.com/username/repo?”

3. saveCodebase

   • Purpose: Saves the codebase analysis to a file for later use
   • Use when: You want to preserve the codebase snapshot or share it
   • Example prompt: “Save an analysis of this codebase to review later”

Example Usage in Cursor

Here are some example prompts you can use with the Composer Agent:

"Analyze my current project and explain its main components."

"Can you look at the tensorflow/tensorflow repository and explain how their testing framework works?"

"Save an analysis of my project to 'codebase-analysis.md' in markdown format."

The Composer Agent will automatically use the appropriate tool based on your request.

Usage Outside Cursor