@aidemd-mcp/server

Servidor MCP que aporta desarrollo basado en intenciones a cualquier IDE impulsado por IA. Gestione archivos de especificación .aide que residen junto a su código: el contexto de dominio a partir del cual los arquitectos planifican, los implementadores construyen y el control de calidad (QA) valida.

Características

• Descubrimiento de especificaciones en todo el proyecto con un árbol de divulgación progresiva que muestra intenciones, investigación y especificaciones de QA en cada nivel de su base de código.

• Bootstrap de proyecto con un solo comando mediante aide_init: conecta documentos de metodología, comandos de pipeline y este servidor MCP a su proyecto en un único flujo guiado.

• Cumplimiento automático de convenciones de nomenclatura: aide_scaffold maneja las reglas de cambio de nombre de .aide / intent.aide para que nunca cree especificaciones en conflicto.

• Validación de estado mediante aide_validate: detecta especificaciones huérfanas, descripciones faltantes, enlaces rotos y conflictos de nomenclatura antes de que causen desviaciones.

• Detección de desviaciones de actualización mediante aide_upgrade: compara los artefactos de metodología AIDE de su proyecto con las versiones canónicas y escribe actualizaciones por categoría.

Instalación

Inicio rápido (Claude Code)

La ruta 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 AIDE MCP en .mcp.json (crea el archivo o salta la entrada si ya está presente).

• Escribe el comando de barra /aide:init en .claude/commands/aide/init.md (lo salta si existe).

• Escribe el lanzador aide-tree en .aide/bin/aide-tree.mjs (lo salta si existe).

Todas las operaciones son idempotentes: es seguro volver a ejecutarlas en cualquier momento.

Después de ejecutarlo, abra Claude Code y ejecute /aide:init para completar la configuración.

Configuración manual

Si utiliza un cliente distinto a Claude Code, o prefiere configurar manualmente, añada la entrada del servidor al archivo de configuración MCP de su cliente.

Claude Code

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

O añádalo al archivo .mcp.json de su proyecto:

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

Claude Desktop

Ubicaciones de los archivos 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"]
    }
  }
}

Claude Desktop requiere un cierre completo y volver a abrir después de cualquier cambio de configuración.

Cursor

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

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

VS Code / Copilot

Añada a .vscode/mcp.json:

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

Windsurf

Añada 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, la ubicación y el resumen de cada especificación.

Entradas:

• path (cadena, opcional): Subdirectorio en el que profundizar. Cuando se proporciona, la respuesta se abre 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 que se va a leer.

aide_scaffold

Crea nuevos archivos de especificación .aide con cumplimiento automático de convenciones de nomenclatura. Maneja las reglas de cambio de nombre: las especificaciones de intención son .aide por defecto, pero se convierten en intent.aide cuando existe research.aide en la misma carpeta; crear un research.aide cambia automáticamente el nombre de 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_validate

Ejecuta una comprobación de estado en los archivos de especificación .aide del proyecto. Detecta especificaciones huérfanas, especificaciones faltantes, conflictos de nomenclatura (.aide e 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_init

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

Entradas:

• framework (cadena, opcional): Fuerza un framework específico en lugar de la autodetección. 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. Omita en la primera llamada para obtener un resumen solo de metadatos.

• brainPath (cadena, opcional): Ruta resuelta de la bóveda de cerebro (brain vault). Requerido cuando category=brain.

aide_upgrade

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

Entradas:

• framework (cadena, opcional): Fuerza un framework específico en lugar de la autodetección. 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 desviados o faltantes para esta categoría y devuelve un manifiesto. Uno de: pointer-stub, methodology-docs, version-metadata, commands, agents, skills, mcp, ide. Omita en la primera llamada para obtener un resumen solo de metadatos.

Primeros pasos

Después de añadir el servidor a su cliente MCP, pida a su agente que ejecute aide_init para realizar el bootstrap de la metodología AIDE en su proyecto. Esto instala los documentos de metodología, prepara los comandos de pipeline y conecta todo.

Luego pruebe: "Scaffold an intent spec for my authentication module" (Crea una especificación de intención para mi módulo de autenticación): el agente utilizará aide_discover para mapear su 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