Aider Multi-Coder MCP server

MCP Server is a Python application that enables parallel execution of multiple AI coding tasks using the Aider tool, providing significant efficiency improvements through simultaneous processing. It integrates with the Model Context Protocol (MCP) to standardize AI model interactions and includes detailed reporting on task execution.

Installation

Prerequisites

• Python 3.8 or higher
• Git (for tracking code changes)
• Aider CLI tool

Installing Aider

You can install Aider using one of the following methods:

Option 1: One-line installer (Mac & Linux)

curl -s https://aider.chat/install.sh | sh

Or with wget:

wget -qO- https://aider.chat/install.sh | sh

Option 2: Using pip

python -m pip install aider-install
aider-install

Installing MyMCP

1. Clone the repository:

git clone https://github.com/eiliyaabedini/aider-mcp.git
cd aider-mcp

2. Install requirements:

Using pip

pip install -e .

Manual installation

pip install -r requirements.txt

3. Configure environment variables:

Create a .env file from .env.sample in the project root directory:

# Default model to use if not specified
AIDER_MODEL=gpt-4.1-mini

# Add any other environment variables needed

4. Verify installation:

python tests/test_multiple_ai.py

You should see output showing both parallel and sequential execution of AI coding tasks.

Usage

Setting Up in Claude Desktop

Add the following configuration to use AiderMCP in Claude Desktop:

"AiderMCP": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "mcp",
    "run",
    "/Users/path/to/aider_mcp.py"
  ]
}

Basic Usage

To use the MCP server with Claude Desktop:

1. Ask your MCP client (Claude Desktop) to use the code_with_ai or code_with_multiple_ai tool for coding tasks
2. Provide the full path where files should be created
3. Structure your prompt to effectively divide work into parallel tasks

Example Workflow

Here's how to structure a complex coding project for parallel execution:

1. First create planning documents (Readme.md and Architecture.md)
2. Design tasks in branches that can run independently:

Branch 1: Front end → Task1: initiate front end, Task2: implement index page
Branch 2: Back end → Task1: initiate backend, Task2: implement API
Branch 3: Database → Task1: initiate database, Task2: implement database

You can then run all "Task1" items in parallel since they don't depend on each other.

Running Tests

To verify functionality and compare parallel vs. sequential execution:

python tests/test_multiple_ai.py

Troubleshooting

If the code_with_multiple_ai tool fails, stop the process and check:

• Environment variables configuration
• Aider installation status
• Network connectivity for API access
• Python version compatibility

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 "aider-mcp" '{"command":"uv","args":["run","--with","mcp[cli]","mcp","run","/Users/path/to/aider_mcp.py"]}'

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": {
        "aider-mcp": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/path/to/aider_mcp.py"
            ]
        }
    }
}

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": {
        "aider-mcp": {
            "command": "uv",
            "args": [
                "run",
                "--with",
                "mcp[cli]",
                "mcp",
                "run",
                "/Users/path/to/aider_mcp.py"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect