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 :

Uso de PIP

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.

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:

IDE de cursor

Para integrar con Cursor IDE:

1. Abrir configuración del cursor

2. Vaya a Features > MCP Servers

3. Haga clic Add new MCP server

4. Ingrese a esta configuración:

   name: aider-mcp type: command command: uvx aider-mcp --repo-path=/path/to/your/repo

5. 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:

1. 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

2. 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

3. 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:

El inspector proporciona una interfaz de usuario interactiva para:

1. Ver las herramientas disponibles y sus esquemas

2. Llamar a herramientas con parámetros de prueba

3. Ver las respuestas y depurar problemas

Desarrollo

Para el desarrollo local:

Licencia

Sin licencia