Aider MCP Server - Experimental

Model context protocol server for offloading AI coding work to Aider, enhancing development efficiency and flexibility.

Overview

Setup

1. Clone the repository:

1. Install dependencies:

1. Create your environment file:

1. Configure your API keys in the .env file (or use the mcpServers "env" section) to have the api key needed for the model you want to use in aider:

1. Copy and fill out the the .mcp.json into the root of your project and update the --directory to point to this project's root directory and the --current-working-dir to point to the root of your project.

Testing

Tests run with gemini-2.5-pro-exp-03-25

Add this MCP server to Claude Code

Add with `gemini-2.5-pro-exp-03-25`

Add with `gemini-2.5-pro-preview-03-25`

Add with `quasar-alpha`

Add with `llama4-maverick-instruct-basic`

Usage

1. Offload AI coding tasks to Aider:

2. List available models:

Available Tools

1. `aider_ai_code`

• ai_coding_prompt (string, required): The natural language instruction for the AI coding task.

• relative_editable_files (list of strings, required): A list of file paths (relative to the current_working_dir) that Aider is allowed to modify. If a file doesn't exist, it will be created.

• relative_readonly_files (list of strings, optional): A list of file paths (relative to the current_working_dir) that Aider can read for context but cannot modify. Defaults to an empty list [].

• model (string, optional): The primary AI model Aider should use for generating code. Defaults to "gemini/gemini-2.5-pro-exp-03-25". You can use the list_models tool to find other available models.

• editor_model (string, optional): The AI model Aider should use for editing/refining code, particularly when using architect mode. If not provided, the primary model might be used depending on Aider's internal logic. Defaults to None.

• A simple dict: {success, diff}

2. `list_models`

• substring (string, required): The substring to search for within the names of available models.

• A list of model name strings that match the provided substring. Example: ["gemini/gemini-1.5-flash", "gemini/gemini-1.5-pro", "gemini/gemini-pro"]

Architecture

• Server layer: Handles MCP protocol communication

• Atoms layer: Individual, pure functional components

Codebase Structure

• `src/aider_mcp_server`: Contains the main application code.

Aider MCP Server - Experimental

Model context protocol server for offloading AI coding work to Aider, enhancing development efficiency and flexibility.

Overview

Setup

1. Clone the repository:

1. Install dependencies:

1. Create your environment file:

1. Configure your API keys in the .env file (or use the mcpServers "env" section) to have the api key needed for the model you want to use in aider:

1. Copy and fill out the the .mcp.json into the root of your project and update the --directory to point to this project's root directory and the --current-working-dir to point to the root of your project.

Testing

Tests run with gemini-2.5-pro-exp-03-25

Add this MCP server to Claude Code

Add with `gemini-2.5-pro-exp-03-25`

Add with `gemini-2.5-pro-preview-03-25`

Add with `quasar-alpha`

Add with `llama4-maverick-instruct-basic`

Usage

1. Offload AI coding tasks to Aider:

2. List available models:

Available Tools

1. `aider_ai_code`

• ai_coding_prompt (string, required): The natural language instruction for the AI coding task.

• relative_editable_files (list of strings, required): A list of file paths (relative to the current_working_dir) that Aider is allowed to modify. If a file doesn't exist, it will be created.

• relative_readonly_files (list of strings, optional): A list of file paths (relative to the current_working_dir) that Aider can read for context but cannot modify. Defaults to an empty list [].

• model (string, optional): The primary AI model Aider should use for generating code. Defaults to "gemini/gemini-2.5-pro-exp-03-25". You can use the list_models tool to find other available models.

• editor_model (string, optional): The AI model Aider should use for editing/refining code, particularly when using architect mode. If not provided, the primary model might be used depending on Aider's internal logic. Defaults to None.

• A simple dict: {success, diff}

2. `list_models`

• substring (string, required): The substring to search for within the names of available models.

• A list of model name strings that match the provided substring. Example: ["gemini/gemini-1.5-flash", "gemini/gemini-1.5-pro", "gemini/gemini-pro"]

Architecture

• Server layer: Handles MCP protocol communication

• Atoms layer: Individual, pure functional components

Codebase Structure

• `src/aider_mcp_server`: Contains the main application code.