Aider MCP WebSocket Server

by larock22

362 downloads Not rated yet MIT license
GitHub

About

WebSocket server that exposes Aider's AI coding capabilities through the Model Context Protocol (MCP) for programmatic access

Details

License
MIT license

Explore

- Full MCP Protocol Support: Standard MCP methods and JSON-RPC 2.0
- Multi-tenant Isolation: One Aider child process per client
- Automatic Completion Detection: Waits for Aider to complete tasks
- Isolated Workspaces: Each session gets its own workspace directory
- OpenAI API Integration: Works with your existing OpenAI API key
- Real-time Communication: WebSocket-based bidirectional communication
- Flexible Configuration: Environment variables and CLI arguments
- Structured Logging: JSON logging with Pino

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Aider MCP WebSocket Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Quick Start

This is a real MCP (Model Context Protocol) server that lets you control Aider programmatically via WebSocket. It's like having Aider as an API.

```bash

The MCP server exposes these tools to clients:

1. aider_command - Execute natural language commands

   {
"name": "aider_command",
"arguments": {
"command": "create a REST API with Flask"
}
}

2. aider_add_file - Add files to Aider's context

   {
"name": "aider_add_file",
"arguments": {
"filename": "app.py"
}
}

3. aider_run_command - Run shell commands through Aider

   {
"name": "aider_run_command",
"arguments": {
"command": "npm test"
}
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "aider mcp websocket server": {
            "aider-mcp": {
                "command": "python3",
                "args": [
                    "test-debug.py"
                ]
            }
        }
    }
}

McpServers

{
    "aider-mcp": {
        "command": "python3",
        "args": [
            "test-debug.py"
        ]
    }
}

Quick Start

This is a real MCP (Model Context Protocol) server that lets you control Aider programmatically via WebSocket. It's like having Aider as an API.

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.