Aider MCP Server Rjn

🚀 Aider MCP Server

Aider MCP Server serves as a bridge between AI assistants (such as ChatGPT) and Aider, enabling code - related tasks. It offers various tools through the Model Context Protocol (MCP) to assist AI in more efficiently conducting code analysis, extraction, and manipulation.

🚀 Quick Start

The Aider MCP Server automatically loads all tools and listens for requests when it is running.

✨ Features

• Code Editing: Edit files within a Git repository.
• New File Creation: Generate new files as required.
• Code Extraction: Extract code blocks from text or Markdown.
• Status Check: Verify the proper operation and configuration of Aider.

📦 Installation

Using uv

# Basic usage
uvx aider-mcp

# Specify the repository path
uvx aider-mcp --repo-path /path/to/your/repo

# Environment variable configuration
AIDER_PATH=/path/to/aider uvx aider-mcp

Using pip

# Clone the repository and install
git clone https://github.com/yourusername/aider-mcp-server.git
cd aider-mcp-server
pip install -e .

# Run the server
python -m aider_mcp

💻 Usage Examples

Basic Usage

When running the server, all tools are automatically loaded, and it listens for requests.

Advanced Usage

Parameter Options

--repo-path <path>   # Specify the Git repository path, default is the current directory
--aider-path <path> # Specify the path to the Aider executable
--verbose           # Enable detailed log output

📚 Documentation

Client Configuration

Claude Desktop

Add the following content to config.json:

{
  "tools": [
    {
      "name": "aider-mcp",
      "description": "A bridge tool for interacting with Aider",
      "path": "uvx aider-mcp --repo-path ${REPO_PATH}"
    }
  ]
}

Cursor IDE

Run via the command line:

npx @modelcontextprotocol/core uvx aider-mcp --repo-path /path/to/your/repo

Aider Configuration Support

• Configuration File: Supports the --aider-config-file parameter to specify the path to a custom configuration file.
• Environment Variables: Supports setting environment variables through a .env file or directly (e.g., AIDER_ENV_FILE).

Example Prompts

Code Extraction

# Extract code blocks from Markdown and save them to the target directory
aider-mcp extract-code --source-file README.md --output-dir ./extracted_code

Status Check

# Check the Aider status and configuration information
aider-mcp aider_status

Environment Variables

• AIDER_PATH: Specify the installation path of Aider.
• REPO_PATH: Specify the path of the Git repository.
• AIDER_CONFIG_FILE: Specify the path to a custom configuration file.
• AIDER_ENV_FILE: Specify the path to a custom environment variable file.
• OPENAI_API_KEY and ANTHROPIC_API_KEY: Used for interacting with the OpenAI or Anthropic APIs.

Debugging

Use the MCP inspector for debugging:

# Basic test
npx @modelcontextprotocol/inspector uvx aider-mcp

# Specify the repository path
npx @modelcontextprotocol/inspector uvx aider-mcp --repo-path /path/to/your/repo

Development Guide

Local Development

git clone https://github.com/yourusername/aider-mcp-server.git
cd aider-mcp-server
pip install -e .

Running the Server

python -m aider_mcp

📄 License

No license information is provided in the original document, so this section is skipped.