Model Control Protocol (MCP)

Model Control Protocol (MCP) servers extend aider’s capabilities by providing additional tools and functionality to the AI models. MCP servers can add features like git operations, context retrieval, and other specialized tools.

Configuring MCP Servers

Aider supports configuring MCP servers using the MCP Server Configuration schema. Please see the Model Context Protocol documentation for more information.

You have two ways of sharing your MCP server configuration with Aider.

Today, Aider-CE/Cecli supports connecting to MCP servers using stdio, http, and sse transports.

Config Files

You can configure MCP servers in your .aider.conf.yml file using either JSON or YAML format:

JSON Configuration

mcp-servers: |
  {
    "mcpServers": {
      "git": {
        "transport": "http",
        "url": "http://localhost:8000"
      }
    }
  }

YAML Configuration

mcp-servers:
  mcpServers:
    context7:
      transport: http
      url: https://mcp.context7.com/mcp
    deepwiki:
      transport: http
      url: https://mcp.deepwiki.com/mcp

Or specify a configuration file:

mcp-servers-file: /path/to/mcp.json

These options are configurable in any of Aider’s config file formats.

Flags

You can specify MCP servers directly on the command line using the --mcp-servers option with a JSON or YAML string:

Using a JSON String

aider --mcp-servers '{"mcpServers":{"git":{"transport":"http","url":"http://localhost:8000"}}}'

Using a YAML String

aider --mcp-servers 'mcpServers:
  context7:
    transport: http
    url: https://mcp.context7.com/mcp
  deepwiki:
    transport: http
    url: https://mcp.deepwiki.com/mcp'

Using a configuration file

Alternatively, you can store your MCP server configurations in a JSON or YAML file and reference it with the --mcp-servers-file option:

aider --mcp-servers-file mcp.json

Specifying the transport

You can use the --mcp-transport flag to specify the transport for all configured MCP servers that do not have a transport specified.

aider --mcp-transport http

Environment Variables

You can also configure MCP servers using environment variables in your .env file using JSON or YAML format:

AIDER_MCP_SERVERS={"mcpServers":{"git":{"transport": "stdio", "command":"uvx","args":["mcp-server-git"]}}}

Or specify a configuration file:

AIDER_MCP_SERVERS_FILE=/path/to/mcp.json

Troubleshooting

If you encounter issues with MCP servers:

1. Use the --verbose flag to see detailed information about MCP server loading
2. Check that the specified executables are installed and available in your PATH
3. Verify that your JSON or YAML configuration is valid

For more information about specific MCP servers and their capabilities, refer to their respective documentation.

Common MCP Servers

Here are some commonly used MCP servers that can enhance aider’s capabilities:

Context7

Context7 MCP provides up-to-date, version-specific documentation and code examples directly from the source into your LLM prompts, eliminating outdated information and hallucinations. It offers a streamlined integration experience with built-in caching mechanisms and is optimized for explorative agentic workflows.

mcp-servers:
  mcpServers:
    context7:
      transport: http
      url: https://mcp.context7.com/mcp

DeepWiki

DeepWiki MCP is an unofficial server that crawls Deepwiki URLs, converts pages to Markdown, and returns them as a single document or a list. It features domain safety, HTML sanitization, and link rewriting to provide clean, structured documentation from Deepwiki repositories.

mcp-servers:
  mcpServers:
    deepwiki:
      transport: http
      url: https://mcp.deepwiki.com/mcp

Serena

Serena MCP provides LSP support for the current project, offering code analysis, symbol navigation, and project-specific tooling. It runs as a local stdio server and provides context-aware development assistance directly within the IDE environment.

mcp-servers:
  mcpServers:
    serena:
      transport: stdio
      command: uvx
      args: [
        "--from",
        "git+https://github.com/oraios/serena",
        "serena",
        "start-mcp-server",
        "--context",
        "ide",
        "--project",
        "{project path}"
      ]

Chrome DevTools

Chrome DevTools MCP provides browser automation and debugging capabilities through Chrome’s DevTools Protocol, enabling web page interaction, network monitoring, and performance analysis. It connects to a running Chrome instance and offers tools for web development testing and automation. Note: the configuration below requires you to start chrome with remote debugging enabled before starting the coding agent.

mcp-servers:
  mcpServers:
    chrome-devtools:
      transport: stdio
      command: npx
      args: [
        "chrome-devtools-mcp@latest",
        "--browser-url",
        "http://127.0.0.1:9222"
      ]