aidemd-mcp

Archivos de especificación .aide estructurados que brindan a los agentes de IA una divulgación progresiva de la arquitectura de tu código base. 6 herramientas MCP, 8 comandos de barra, asistente TUI, soporte multi-IDE.

GitHub

Prueba este MCPPatrocinado

Documentación

@aidemd-mcp/server

Servidor MCP que lleva el desarrollo impulsado por intenciones a cualquier IDE impulsado por IA. Gestiona archivos de especificación .aide que viven junto a tu código — el contexto de dominio desde el que los arquitectos planifican, los implementadores construyen y QA valida.

Aprende más en aidemd.dev.

Características

Descubrimiento de especificaciones en todo el proyecto con un árbol de divulgación progresiva que muestra especificaciones de intención, investigación y QA en cada nivel de tu base de código
Arranque de proyecto con un solo comando mediante aide_init — conecta la documentación de metodología, los comandos de pipeline y este servidor MCP en tu proyecto en un único flujo guiado
Aplicación automática de convenciones de nomenclatura — aide_scaffold maneja las reglas de renombrado .aide / intent.aide para que nunca crees especificaciones conflictivas
Validación de comprobación de salud mediante aide_validate — detecta especificaciones huérfanas, descripciones faltantes, enlaces rotos y conflictos de nomenclatura antes de que causen desviación
Introspección de código mediante aide_inspect — devuelve JSDoc, firmas y tipo para símbolos nombrados sin abrir archivos, dando a los agentes divulgación progresiva de Nivel 2 para el código
Detección de desviación de actualización mediante aide_upgrade — compara los artefactos de metodología AIDE de tu proyecto con versiones canónicas y escribe actualizaciones por categoría
Punto de entrada de cerebro en tiempo de ejecución mediante aide_brain — herramienta bajo demanda que devuelve prosa lista para ejecutar que le dice al agente qué herramientas MCP llamar y cómo llegar al backend de cerebro que esté conectado, sin que el agente sepa qué backend es

Instalación

Inicio rápido (Claude Code)

La vía más rápida es un único comando npx que conecta todo automáticamente:

npx @aidemd-mcp/server@latest init

Este comando:

Fusiona la entrada del servidor MCP AIDE en .mcp.json
Fusiona una entrada MCP de cerebro de marcador de posición en .mcp.json (ruta de vault completada por /aide)
Escribe cada comando de barra de pipeline en .claude/commands/aide/
Instala 9 agentes de pipeline canónicos en .claude/agents/aide/
Instala habilidades (study-playbook, brain) en .claude/skills/
Instala el centro de documentación de metodología en .aide/docs/
Escribe el lanzador aide-tree en .aide/bin/aide-tree.mjs
Añade una insignia AIDE a README.md (agrega si no está presente)

Todas las operaciones son aditivas — los archivos que ya existen nunca se sobrescriben. Seguro de volver a ejecutar en cualquier momento.

Pasa --vault-path <path> para registrar la ubicación de tu vault de cerebro en el momento de la instalación, omitiendo el aviso de ruta de vault cuando /aide se ejecute por primera vez.

Después de ejecutar, abre Claude Code y ejecuta /aide — el orquestador solicitará cualquier configuración que la CLI no pudo completar (elección de IDE, ruta de vault si no se proporcionó).

Sincronizando brain.aide a .mcp.json

Ejecuta esto después de editar .aide/config/brain.aide — por ejemplo, cuando actualices el argumento de ruta de vault en mcpServerConfig.args o renombres el cerebro en el campo name:

npx @aidemd-mcp/server@latest sync

sync lee .aide/config/brain.aide, copia mcpServerConfig textualmente en .mcp.json bajo la clave fija brain, y escribe el campo name como etiqueta del servidor. Cada otra clave en mcpServers (incluyendo tu entrada aide y cualquier integración MCP personal) se deja byte-idéntica. Si una clave heredada obsidian está presente, se elimina en la misma escritura. El comando es idempotente — ejecutarlo dos veces produce los mismos bytes .mcp.json, y la segunda invocación imprime already in sync sin tocar el archivo. El código de salida es 0 en éxito (incluyendo el caso sin cambios), 1 en un brain.aide faltante o malformado o .mcp.json inválido, y 2 en --help.

Ejemplo de salida después de actualizar la ruta de vault en mcpServerConfig.args:

Read .aide/brain.aide
Wrote brain MCP entry into .mcp.json
  command: npx
  args: [-y, obsidian-mcp, D:/notes/new-vault]
Done.

Configuración manual

Si usas un cliente distinto de Claude Code, o prefieres configurar manualmente, añade la entrada del servidor al archivo de configuración MCP de tu cliente.

Claude Code

claude mcp add aide npx -- -y @aidemd-mcp/server@latest

O añade al .mcp.json de tu proyecto:

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

[!NOTE] El comando de Inicio rápido anterior maneja esto automáticamente para usuarios de Claude Code.

Claude Desktop

Ubicaciones del archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

[!NOTE] Claude Desktop no hereda el PATH del terminal. Si usas nvm o Homebrew para gestionar Node, npx puede no encontrarse. Ejecuta which npx en tu terminal para obtener la ruta absoluta y reemplaza "npx" con ella en la configuración anterior.

Claude Desktop requiere un cierre y reapertura completa después de cualquier cambio de configuración.

Cursor

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

VS Code / Copilot

Añade a .vscode/mcp.json:

{
  "servers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

[!NOTE] VS Code / Copilot usa "servers" como clave raíz, no "mcpServers". Usar la clave raíz incorrecta hace que el servidor falle silenciosamente al cargar.

Windsurf

Añade a ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

Herramientas

aide_discover

Escanea el proyecto en busca de archivos de especificación .aide y devuelve un mapa de árbol de divulgación progresiva que muestra el tipo, ubicación y resumen de cada especificación.

Entradas:

path (cadena, opcional): Subdirectorio en el que profundizar. Cuando se proporciona, la respuesta comienza con la cadena de ancestros — el linaje de intención en cascada desde la raíz hasta el objetivo, cada ancestro mostrando su descripción y estado de alineación — seguido del subárbol detallado con resúmenes y advertencias. Cuando se omite, devuelve un mapa superficial de todo el proyecto (solo ubicaciones y tipos).

aide_read

Lee un archivo de especificación .aide con contexto completo, devolviendo el contenido del archivo, su tipo clasificado (intención/investigación/plan/todo), especificaciones relacionadas en el mismo directorio y enlaces encontrados en el contenido.

Entradas:

path (cadena, requerido): Ruta al archivo .aide a leer.

aide_scaffold

Crea nuevos archivos de especificación .aide con aplicación automática de convenciones de nomenclatura. Maneja las reglas de renombrado: las especificaciones de intención son .aide por defecto pero se convierten en intent.aide cuando research.aide existe en la misma carpeta; crear un research.aide renombra automáticamente cualquier .aide existente a intent.aide.

Entradas:

directory (cadena, requerido): Directorio donde se crearán los archivos .aide.
type (cadena, requerido): Tipo de archivo .aide a crear. Uno de: intent, research, both, todo, plan.

aide_inspect

Devuelve el bloque JSDoc, la firma y el tipo para una función, método, clase, interfaz o alias de tipo nombrado en el espacio de trabajo — divulgación progresiva de Nivel 2 para el código. Los agentes pueden entender el contrato de un símbolo sin abrir el archivo.

Entradas:

name (cadena, requerido): Nombre del símbolo a buscar.
file (cadena, opcional): Restringe la búsqueda a un solo archivo (relativo a la raíz del proyecto).

aide_validate

Ejecuta una comprobación de salud en los archivos de especificación .aide del proyecto. Detecta especificaciones huérfanas, especificaciones faltantes, conflictos de nomenclatura (.aide y intent.aide en la misma carpeta), enlaces rotos, archivos de investigación huérfanos y descripciones de frontmatter faltantes.

Entradas:

path (cadena, opcional): Subdirectorio a validar. Por defecto, todo el proyecto cuando se omite.

aide_info

Reportero de precondiciones en el arranque. Devuelve dos campos independientes sobre los que el orquestador ramifica por separado: outdated (un array de claves de artefactos AIDE obsoletos, comparando el versions.json del proyecto contra el manifiesto enviado), y brain (un objeto { status, name?, hints } que informa si la configuración brain.aide del proyecto está conectada a .mcp.json). brain.status es la unión de cuatro estados ok | no-brain-aide | no-mcp-entry | mcp-drift, derivada comparando .aide/config/brain.aide contra .mcp.json — sin validación de ruta en disco. name es la etiqueta declarada por el usuario de brain.aide (solo presente en estados no no-brain-aide). hints es un array de ubicaciones candidatas de vault que el orquestador puede mostrar durante la recuperación.

Entradas:

(ninguna)

aide_brain

Herramienta de punto de entrada de cerebro bajo demanda. Llama a esto cuando necesites llegar al cerebro a mitad de tarea — NO lo llames en cada arranque /aide. El estado de precondición del cerebro en el arranque ya es reportado por aide_info.brain.status; disparar aide_brain en el arranque duplica ese trabajo innecesariamente.

Devuelve { status, instructions } — exactamente dos campos. Sin backend, sin connector, sin name. status refleja aide_info.brain.status (ok | no-brain-aide | no-mcp-entry | mcp-drift). instructions siempre es no vacío: en ok es el cuerpo ## Prose textual del .aide/config/brain.aide del usuario (sin sustitución del servidor); en los estados de fallo lleva prosa de remediación fija que nombra el comando de recuperación CLI correcto (npx @aidemd-mcp/server@latest init para no-brain-aide, npx @aidemd-mcp/server@latest sync para no-mcp-entry y mcp-drift).

Entradas:

(ninguna)

aide_init

Inicializa el entorno de desarrollo AIDE en un proyecto usando un asistente guiado de uno a la vez. En la primera llamada (sin category), devuelve un resumen de cada paso con estado y framework detectado. En llamadas posteriores (con category), escribe todos los archivos pendientes para esa categoría en disco y devuelve un manifiesto.

Entradas:

framework (cadena, opcional): Fuerza un framework específico en lugar de auto-detectar. Uno de: claude, cursor, windsurf, copilot.
path (cadena, opcional): Ruta raíz personalizada del proyecto. Por defecto, el directorio de trabajo del servidor.
category (cadena, opcional): Escribe todos los archivos would-create para esta categoría y devuelve un manifiesto. Uno de: framework, methodology, commands, agents, skills, mcp, brain, ide, readme. Omite en la primera llamada para obtener un resumen solo de metadatos.
brainPath (cadena, opcional): Ruta resuelta del vault de cerebro. Requerida cuando category=brain.

aide_upgrade

Compara los artefactos de metodología AIDE en este proyecto contra versiones canónicas y devuelve un diff estructurado agrupado por categoría. En la primera llamada (sin category), devuelve un resumen ligero de cada categoría con estado de desviación. En llamadas posteriores (con category), escribe todos los archivos con diferencias o faltantes para esa categoría en disco y devuelve un manifiesto.

Entradas:

framework (cadena, opcional): Fuerza un framework específico en lugar de auto-detectar. Uno de: claude, cursor, windsurf, copilot.
path (cadena, opcional): Ruta raíz personalizada del proyecto. Por defecto, el directorio de trabajo del servidor.
category (cadena, opcional): Escribe todos los archivos con desviación o faltantes para esta categoría y devuelve un manifiesto. Uno de: pointer-stub, methodology-docs, version-metadata, commands, agents, skills, mcp, ide, readme. Omite en la primera llamada para obtener un resumen solo de metadatos.

Primeros pasos

Después de añadir el servidor a tu cliente MCP, pide a tu agente que ejecute aide_init para inicializar la metodología AIDE en tu proyecto. Esto instala la documentación de metodología, crea los comandos de pipeline y conecta todo.

Luego intenta: "Crea una especificación de intención para mi módulo de autenticación" — el agente usará aide_discover para mapear tu proyecto y aide_scaffold para crear la especificación en el lugar correcto con las convenciones de nomenclatura adecuadas.

Desarrollo

npm install
npm run build
npm test

Licencia

MIT