Codebase Retrieval (RepoMix) MCP server

This MCP server implementation provides robust tools for retrieving and analyzing entire codebases using RepoMix. It enables AI agents like Cursor's Composer to comprehensively understand projects at once, making it significantly easier to work with large codebases.

Installation

Installing from NPM (Recommended)

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

# Install RepoMix (required dependency)
codebase-mcp install

Installing 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

Follow these steps to integrate the MCP server 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 these details:
   • Name: Codebase MCP (or any name you prefer)
   • Type: command
   • Command: codebase-mcp start
6. Click "Add" to save

Available Tools

Once integrated, you'll have access to three powerful tools:

1. getCodebase

This tool analyzes your current workspace/project. Use it when you want the AI to understand your entire codebase.

Example prompt: "Please analyze my codebase to understand its structure"

2. getRemoteCodebase

This tool fetches and analyzes any public GitHub repository. It's useful when you want to explore or understand external projects.

Example prompt: "Can you analyze the repository at github.com/username/repo?"

3. saveCodebase

This tool saves the codebase analysis to a file for later reference. Use it when you want to preserve a codebase snapshot or share it.

Example prompt: "Save an analysis of this codebase to review later"

Example Usage in Cursor

Here are sample 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 automatically selects the appropriate tool based on your request.

Usage Outside Cursor

Starting the MCP Server

To start the MCP server in stdio mode (compatible with any MCP clients):

codebase-mcp start

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "codebase-mcp" '{"command":"codebase-mcp","args":["start"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "codebase-mcp": {
            "command": "codebase-mcp",
            "args": [
                "start"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "codebase-mcp": {
            "command": "codebase-mcp",
            "args": [
                "start"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect