Servidor Aider MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude y otros clientes MCP conectarse a Aider para obtener capacidades eficientes de edición de archivos.

Descripción general

Este servidor MCP conecta a asistentes de IA como Claude con las potentes capacidades de edición de archivos de Aider. Proporciona una interfaz estandarizada mediante el Protocolo de Contexto de Modelo, lo que permite a Claude:

Edite archivos existentes utilizando las capacidades de Aider
Crear nuevos archivos con contenido
Extraer bloques de código del texto de Markdown
Obtener información del estado de Git
Verificar el estado de instalación de Aider
Acceder y utilizar el sistema de configuración de Aider

Prerrequisitos

Python 3.8 o superior
Aider instalado ( pip install aider-chat )
Una clave API para OpenAI o Anthropic (dependiendo del modelo que desee que utilice Aider)
Repositorio Git para edición de archivos

Instalación

Puede instalar el servidor Aider MCP de varias maneras:

Uso de UV (recomendado)

Si tienes instalado uv :

# Install uv if you don't have it
curl -fsSL https://astral.sh/uv/install.sh | bash

# Run directly with uvx (no installation required)
uvx aider-mcp

Uso de PIP

# Install the package
pip install aider-mcp

# Run the server
aider-mcp

Uso

El servidor MCP de Aider se ejecuta en modo de protocolo MCP sobre stdio de forma predeterminada, que está diseñado para la integración directa con clientes MCP como Claude Desktop y Cursor IDE.

# Run directly with uvx (recommended)
uvx aider-mcp

# With repository path specified
uvx aider-mcp --repo-path=/path/to/your/repo

# With custom Aider executable path
uvx aider-mcp --aider-path=/path/to/aider

# With environment variables
REPO_PATH=/path/to/your/repo uvx aider-mcp

Opciones de línea de comandos

Puede personalizar el servidor con estas variables de entorno o argumentos de línea de comandos:

--aider-path : Ruta al ejecutable de Aider (predeterminado: "aider", busca automáticamente PATH)
--repo-path : Ruta al repositorio git (predeterminado: directorio actual)
--config-file : Ruta a un archivo de configuración de Aider personalizado
--env-file : Ruta a un archivo .env personalizado
--verbose , -v : Habilitar salida detallada

Configuración del cliente

Escritorio de Claude

Agregue esto a su archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "aider-mcp": {
      "command": "uvx",
      "args": [
        "aider-mcp",
        "--repo-path", "/path/to/your/repo"
      ]
    }
  }
}

IDE de cursor

Para integrar con Cursor IDE:

Abrir configuración del cursor
Vaya a Features > MCP Servers
Haga clic Add new MCP server
Ingrese a esta configuración:
name: aider-mcp type: command command: uvx aider-mcp --repo-path=/path/to/your/repo
Después de la configuración, asegúrese de estar en modo Agente en Composer para usar las herramientas MCP

Soporte de configuración de Aider

Este servidor MCP admite el sistema de configuración de Aider, lo que le permite:

Utilice la configuración de los archivos .aider.conf.yml en:
- Su directorio de inicio
- La raíz del repositorio git
- El directorio actual
- Una ruta personalizada especificada con --config-file
Utilice variables de entorno de archivos .env en:
- Su directorio de inicio
- La raíz del repositorio git
- El directorio actual
- Una ruta personalizada especificada con --env-file
Pase opciones personalizadas de Aider al editar archivos a través de las herramientas MCP.

Ejemplos de indicaciones para Claude

Una vez conectado a Claude, puedes usar indicaciones como:

"Editar mi archivo app.py para agregar manejo de errores a la función principal"
"Crea un nuevo archivo llamado utils.py con funciones auxiliares para el formato de fecha"
"Muéstrame el estado actual de Git del repositorio"
Extrae el código Python de esta explicación y guárdalo en un archivo.

Herramientas disponibles

El servidor MCP proporciona estas herramientas basadas en directorio:

edit_files : Realiza cambios de código específicos en un directorio específico
- Requiere una ruta de directorio e instrucciones detalladas
- Acepta automáticamente todos los cambios propuestos (usa --yes-always )
- Se pueden especificar opciones de Aider adicionales cuando sea necesario
create_files : Crea nuevos archivos con contenido en un directorio específico
- Puede proporcionar varios archivos para crearlos a la vez
- Opcionalmente, confirme los nuevos archivos en git
git_status : obtiene el estado git del repositorio de un directorio específico
- Una forma rápida de comprobar si hay archivos modificados, agregados, eliminados o no rastreados
extract_code : Extrae bloques de código de Markdown o texto
- Opcionalmente, puede guardar bloques de código extraídos en archivos en un directorio específico
- Conserva la información del idioma de los marcadores de bloques de código
aider_status : comprueba la instalación de Aider y el estado del entorno.
- Verifica que Aider esté correctamente instalado y accesible
- Puede comprobar directorios específicos para la configuración
- Informes sobre claves API y variables de entorno
aider_config : Obtenga información detallada sobre la configuración de Aider.
- Muestra qué archivos de configuración se están utilizando
- Muestra la configuración de todas las capas de configuración.
- Informa sobre las variables de entorno disponibles

Variables de entorno

El servidor utiliza variables de entorno que se pueden configurar directamente o mediante archivos .env :

AIDER_PATH : Ruta al ejecutable de Aider
REPO_PATH : Ruta al repositorio git
AIDER_CONFIG_FILE : Ruta a un archivo de configuración de Aider personalizado
AIDER_ENV_FILE : Ruta a un archivo .env personalizado
AIDER_MCP_VERBOSE : Habilitar el registro detallado
OPENAI_API_KEY : Su clave API de OpenAI (si usa GPT-4 con Aider)
ANTHROPIC_API_KEY : Su clave API antrópica (si usa Claude con Aider)

Depuración

Puede utilizar el inspector MCP para depurar el servidor:

# Test with MCP inspector
npx @modelcontextprotocol/inspector uvx aider-mcp

# Test with specific repository path
npx @modelcontextprotocol/inspector uvx aider-mcp --repo-path=/path/to/your/repo

# If running from Python package
npx @modelcontextprotocol/inspector python -m aider_mcp

El inspector proporciona una interfaz de usuario interactiva para:

Ver las herramientas disponibles y sus esquemas
Llamar a herramientas con parámetros de prueba
Ver las respuestas y depurar problemas

Desarrollo

Para el desarrollo local:

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

Licencia

Sin licencia

Aider MCP Server

Integrations