Servidor MCP

ADHDev incluye un servidor MCP stdio para que los clientes MCP externos puedan usar las sesiones de ADHDev como herramientas. El servidor se publica como @adhdev/mcp-server y también está envuelto por el CLI principal de la nube como adhdev mcp.

Úsalo cuando quieras que un cliente MCP como Claude Desktop liste las sesiones activas de ADHDev, lea el historial de chat, envíe un mensaje o apruebe un prompt en espera.

Modos

Modo	Transporte usado por el servidor MCP	Herramientas
Local standalone	API standalone http://localhost:3847	list_daemons, list_sessions, launch_session, stop_session, send_chat, read_chat, read_chat_debug, approve, check_pending, git_status, git_diff, git_log, git_checkpoint, git_push, screenshot, spec_debug (16 herramientas)
IPC	IPC local del daemon de la nube en localhost:19222	La misma superficie de herramientas enrutadas por comando que el modo local
Mesh	Local o IPC + --repo-mesh <id>	Conjunto con alcance de coordinador (28 herramientas). Estado/inspección: mesh_status, mesh_list_nodes, mesh_read_chat, mesh_read_debug, mesh_git_status, mesh_task_history, mesh_review_inbox. Despacho/sesiones: mesh_send_task, mesh_launch_session, mesh_approve, mesh_checkpoint, mesh_cleanup_sessions, mesh_prune_stale_direct. Cola/misiones: mesh_enqueue_task, mesh_view_queue, mesh_queue_cancel, mesh_queue_requeue, mesh_mission_upsert, mesh_reconcile_ledger. Nodos: mesh_clone_node, mesh_remove_node, mesh_fast_forward_node. Refinery: mesh_refine_node, mesh_refine_batch, mesh_refine_plan, mesh_refine_config_schema, mesh_suggest_refine_config, mesh_validate_refine_config

El modo local es parte de la superficie OSS/autoalojada. Para los detalles de configuración y autenticación de standalone, usa la documentación de OSS:

• Configuración autoalojada
• API local autoalojada

Iniciar el servidor

# Local mode: requires a running standalone daemon
adhdev mcp
adhdev mcp --port 4000
adhdev mcp --password my-standalone-password

También puedes ejecutar el paquete OSS directamente:

npx @adhdev/mcp-server
npx @adhdev/mcp-server --mode ipc --repo-mesh mesh_abc123

Se admiten variables de entorno:

ADHDEV_PASSWORD=my-standalone-password adhdev mcp
ADHDEV_MESH_ID=mesh_abc123 adhdev mcp

Configuración de Claude Desktop

{
  "mcpServers": {
    "adhdev": {
      "command": "adhdev",
      "args": ["mcp"]
    }
  }
}

Para el modo mesh (herramientas con alcance de coordinador):

{
  "mcpServers": {
    "adhdev-mesh": {
      "command": "adhdev",
      "args": ["mcp", "--mode", "ipc", "--repo-mesh", "mesh_abc123"]
    }
  }
}

Configuración de mesh para Hermes Agent

Hermes Agent no importa automáticamente el .mcp.json local del repo. Para usar herramientas de Repo Mesh desde Hermes, añade el servidor mesh a la configuración YAML de Hermes bajo mcp_servers, luego inicia una sesión de Hermes nueva.

Encuentra el archivo de configuración de Hermes:

hermes config path

Añade una entrada de servidor mesh:

mcp_servers:
  adhdev-mesh:
    command: adhdev
    args:
      - mcp
      - --mode
      - ipc
      - --repo-mesh
      - mesh_abc123
    enabled: true

Después de guardar la configuración, sal y relanza Hermes. Las herramientas MCP se descubren cuando se inicia la sesión de Hermes, por lo que una sesión ya en ejecución puede no ver el nuevo servidor mesh.

Notas sobre las herramientas

• list_daemons reporta la identidad del daemon conectado.
• list_sessions descubre las sesiones disponibles en un daemon.
• launch_session y stop_session gestionan los ciclos de vida de los agentes CLI/IDE.
• read_chat lee el chat reciente de una sesión seleccionada.
• send_chat envía un mensaje a una sesión seleccionada.
• approve aprueba o rechaza un prompt de aprobación.
• check_pending lista las sesiones que esperan aprobación.
• git_status, git_diff, git_log, git_checkpoint, git_push gestionan las operaciones de git del workspace.
• screenshot captura la ventana actual del IDE a través del daemon.

Herramientas de mesh

Las herramientas de mesh solo están disponibles en modo mesh (--repo-mesh). Reemplazan las herramientas estándar con un conjunto de 28 herramientas con alcance de coordinador.

Estado e inspección

• mesh_status — snapshot agregado: salud de todos los nodos, estado de git y sesiones activas (propiedad del coordinador).
• mesh_list_nodes — lista los nodos con rutas de workspace y capacidades.
• mesh_read_chat — lee el historial de chat de un agente delegado.
• mesh_read_debug — paquete de depuración acotado para una sesión delegada.
• mesh_git_status — obtiene el estado de git para un workspace de nodo.
• mesh_task_history — historial compacto de tareas a través del mesh.
• mesh_review_inbox — elementos de revisión/aprobación pendientes que esperan al coordinador.

Despacho y sesiones

• mesh_send_task — envía una tarea en lenguaje natural directamente a una sesión de agente delegado.
• mesh_launch_session — lanza una nueva sesión de agente en un nodo del mesh.
• mesh_approve — aprueba/rechaza una acción pendiente en un agente delegado.
• mesh_checkpoint — crea un checkpoint de git en un workspace de nodo.
• mesh_cleanup_sessions — detiene/limpia sesiones delegadas obsoletas o huérfanas.
• mesh_prune_stale_direct — poda registros de despacho directo obsoletos.

Cola de trabajo y misiones

• mesh_enqueue_task — encola una tarea que un nodo inactivo reclama de forma autónoma (admite enrutamiento target_node_id / prefer_worktree, task_mode, mission_id, depends_on).
• mesh_view_queue — fuente de verdad actual del trabajo activo (pending/assigned/terminal).
• mesh_queue_cancel / mesh_queue_requeue — cancela o vuelve a encolar una tarea en cola.
• mesh_mission_upsert — crea/actualiza una misión (agrupación de objetivo + estado de ciclo de vida).
• mesh_reconcile_ledger — reconcilia el ledger local contra la porción acotada de un par.

Nodos

• mesh_clone_node — clona un nodo en un nodo de worktree de git aislado.
• mesh_remove_node — elimina un nodo (de worktree), opcionalmente limpiando sesiones.
• mesh_fast_forward_node — hace dry-run de forma segura por defecto, o ejecuta explícitamente, un fast-forward limpio y obvio sin lanzar una sesión de agente; usa fetch/recheck, merge --ff-only, actualización opcional de submódulos y solo verificación de estado posterior.

Refinery (convergencia worktree → base)

• mesh_refine_node / mesh_refine_batch — converge una o varias ramas de worktree de vuelta a la base (validar → merge → push → limpieza).
• mesh_refine_plan — previsualiza el plan de convergencia sin ejecutarlo.
• mesh_refine_config_schema / mesh_suggest_refine_config / mesh_validate_refine_config — inspecciona, genera y valida la configuración de refine del proyecto.

Referencias relacionadas

• Comandos CLI
• Claves de API
• REST API