hcom-mcp

Servidor MCP de plano de control para lanzar y supervisar agentes gestionados por hcom.

Por qué HTTP, no stdio

Los servidores MCP normalmente se ejecutan sobre stdio — el cliente lanza un proceso de servidor por sesión. Para un servidor de plano de control que gestiona una flota de agentes, eso es un problema: diez sesiones de terminal lanzan diez procesos MCP aislados sin coordinación entre ellos.

hcom-mcp se ejecuta como un único servidor HTTP persistente. Cada sesión de terminal, cada cliente MCP, cada agente se comunica con el mismo endpoint. Un solo proceso, una única fuente de verdad para lanzamientos, registros y ciclo de vida.

Related MCP server: GRACE Orchestrator MCP

Requisitos previos

• Node.js 22+

• CLI de hcom instalada y en PATH

Instalación

git clone https://github.com/scchearn/hcom-mcp.git
cd hcom-mcp
npm install
npm run build

Ejecución

En primer plano (cualquier sistema operativo)

HCOM_MCP_PORT=3111 node dist/index.js

Escucha en http://127.0.0.1:3111/mcp. Solo se aceptan conexiones de localhost.

Como daemon

Ajusta la ruta de ExecStart/ProgramArguments en la configuración para que coincida con el lugar donde clonaste el repositorio.

Configuración del cliente MCP

Apunta cualquier cliente MCP compatible con HTTP a http://127.0.0.1:3111/mcp. Ejemplo para Claude Desktop:

{
  "mcpServers": {
    "hcom-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:3111/mcp"
    }
  }
}

Configuración

• HCOM_MCP_PORT — puerto HTTP (por defecto: 3111)

• ~/.hcom/mcp/config.json — preajustes, topologías, catálogos de modelos, lista de permitidos de rescate

• ~/.hcom/mcp/registry.json — registro de agentes gestionados

• .hcom-mcp.json — superposición de espacio de trabajo opcional (consulta .hcom-mcp.example.json)

Lista de permitidos de rescate

unblock y spawn_and_verify solo inyectan entrada en un agente bloqueado cuando el detalle pendiente de launch_blocked coincide con un patrón de rescueAllowlist. Los valores predeterminados cubren los diálogos rescatables conocidos (confianza del espacio de trabajo, modo de permisos, selector de modelo/proveedor); añade patrones para nuevos diálogos sin necesidad de publicar código:

{
  "rescueAllowlist": {
    "enabled": true,
    "patterns": ["trust this folder", "permission mode"]
  }
}

Las superposiciones de espacio de trabajo amplían los patrones globales; no pueden eliminar los valores predeterminados integrados.

Habilidades

Instala con:

npx skills add scchearn/hcom-mcp

La guía operativa se incluye en skills/:

• skills/using-hcom/SKILL.md — mensajería, hilos, transcripciones, observación de eventos

• skills/hcom-agent-messaging/SKILL.md — patrones de mensajería entre agentes y errores comunes

Herramientas

Licencia

MIT