Aider MCP Server

🚀 Aider MCP Server

An MCP (Machine Cognition Protocol) server powered by Aider to provide AI programming capabilities.

🚀 Quick Start

The Aider MCP server offers programming capabilities through a standardized API by leveraging Aider, a powerful AI programming assistant. By offloading tasks to Aider, we can reduce costs while harnessing its features.

✨ Features

• AI Code Generation: Automatically generate high - quality code.
• Model Selection: Choose the appropriate model according to your needs.
• Flexible Configuration: Support custom settings to meet the requirements of different scenarios.

📦 Installation

Prerequisites

• Python Version: Python 3.10 or higher is required.
• API Key: Configure the required API access key.

Installation Steps

# Example installation command
pip install aider-mcp-server

📚 Documentation

Configuration

Configure using environment variables:

Running the Server

Using the Command Line

# Example running command
python -m aider_mcp_server --port 8050

Using a Custom Configuration File

Create a configuration file config.json:

{
  "port": 8050,
  "models": {
    "default": "gemini/gemini-2.5-pro-preview-03-25"
  }
}

MCP Tools

AI Programming Tool

Features

• Code Generation: Automatically generate code snippets.
• Model Selection: Support multiple programming models.

Example Configuration

{
  "ai_coding_prompt": "Implement a function to calculate the factorial",
  "relative_editable_files": ["math.py"],
  "settings": {
    "auto_commits": false,
    "use_git": false
  }
}

Model Management Tool

Features

• Model Listing: List all available models.
• Filtering Function: Filter models by substrings.

Integration with MCP Clients

Using Docker

{
    "mcpServers": {
      "aider-mcp-server": {
        "command": "docker",
        "args": [ "run", "-i", "--rm",
          "--mount", "type=bind,source=<YOUR_FULL_PATH>",
          "-e", "TRANSPORT=stdio",
          "-e", "EDITOR_MODEL=gemini/gemini-2.5-pro-preview-03-25",
          "-e", "GEMINI_API_KEY=<YOUR_API_KEY>",
          "danielscholl/aider-mcp-server"
        ]
      }
    }
  }

Using Command - Line Tools

# Example running command
python -m aider_mcp_server --config config.json

Troubleshooting

Common issues and solutions:

1. Unable to connect to the server: Check if the server is running on the correct port.
2. Model loading failed: Ensure that the API key is correct and valid.

📄 License

This project is licensed under the MIT License.