hcom-mcp

Control-Plane-MCP-Server zum Starten und Überwachen von hcom-verwalteten Agenten.

Warum HTTP und nicht stdio

MCP-Server laufen normalerweise über stdio — der Client startet einen Serverprozess pro Sitzung. Für einen Control-Plane-Server, der eine Flotte von Agenten verwaltet, ist das ein Problem: Zehn Terminalsitzungen erzeugen zehn isolierte MCP-Prozesse ohne Koordination untereinander.

hcom-mcp läuft als ein einziger persistenter HTTP-Server. Jede Terminalsitzung, jeder MCP-Client, jeder Agent spricht mit demselben Endpunkt. Ein Prozess, eine einzige Quelle der Wahrheit für Starts, Registries und Lebenszyklus.

Related MCP server: GRACE Orchestrator MCP

Voraussetzungen

• Node.js 22+

• hcom CLI installiert und im PATH

Installation

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

Ausführen

Im Vordergrund (jedes Betriebssystem)

HCOM_MCP_PORT=3111 node dist/index.js

Lauscht auf http://127.0.0.1:3111/mcp. Es werden nur localhost-Verbindungen akzeptiert.

Als Daemon

Passen Sie den ExecStart/ProgramArguments-Pfad in der Konfiguration an den Ort an, an dem Sie das Repository geklont haben.

MCP-Client-Konfiguration

Richten Sie einen beliebigen HTTP-fähigen MCP-Client auf http://127.0.0.1:3111/mcp aus. Beispiel für Claude Desktop:

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

Konfiguration

• HCOM_MCP_PORT — HTTP-Port (Standard: 3111)

• ~/.hcom/mcp/config.json — Presets, Topologien, Modellkataloge, Rescue-Allowlist

• ~/.hcom/mcp/registry.json — Registry der verwalteten Agenten

• .hcom-mcp.json — optionaler Workspace-Overlay (siehe .hcom-mcp.example.json)

Rescue-Allowlist

unblock und spawn_and_verify injizieren Eingaben nur dann in einen blockierten Agenten, wenn das ausstehende launch_blocked-Detail einem Muster in rescueAllowlist entspricht. Die Standardeinstellungen decken die bekannten rettbaren Dialoge ab (Workspace-Vertrauen, Berechtigungsmodus, Modell-/Anbieterauswahl); fügen Sie Muster für neue Dialoge hinzu, ohne ein Code-Release zu benötigen:

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

Workspace-Overlays erweitern die globalen Muster; sie können die integrierten Standardwerte nicht entfernen.

Skills

Installieren mit:

npx skills add scchearn/hcom-mcp

Betriebsanleitungen werden in skills/ mitgeliefert:

• skills/using-hcom/SKILL.md — Messaging, Threads, Transkripte, Ereignisbeobachtung

• skills/hcom-agent-messaging/SKILL.md — Agent-zu-Agent-Messaging-Muster und Stolperfallen

Tools

Lizenz

MIT