herdr-mcp

Ein MCP-Server, der einem Coding-Agenten die Kontrolle über eine laufende Herdr-Terminal-Sitzung gibt: Workspaces, Tabs, Panes und Agenten auflisten, Pane-Ausgaben lesen, andere Agenten anstupsen, Tasten senden, Befehle ausführen, auf Zustand oder Ausgabe warten und Panes teilen oder schließen.

Er ist eine schlanke stdio-Brücke. Jedes Werkzeug ruft die herdr-CLI auf, die bereits Herdrs Socket-API nutzt und mit JSON-Umschlägen antwortet. Es gibt keinen Daemon, keinen Port, keine Konfigurationsdatei und keine Authentifizierung.

Voraussetzungen

• herdr muss installiert und im PATH sein (oder HERDR_BIN auf den vollständigen Pfad setzen).

• Eine laufende Herdr-Sitzung. Der Server spricht mit der Sitzung, die die herdr-CLI aus der Umgebung auflöst (HERDR_SOCKET_PATH / HERDR_SESSION).

• Python 3.12+ und uv.

Related MCP server: HT MCP Server

Ausführen

Aus einem Checkout:

uv run herdr-mcp

Direkt von GitHub, ohne Checkout:

uvx --from git+https://github.com/aelaguiz/herdr-mcp herdr-mcp

Der Prozess bedient MCP über stdio, gibt also nichts auf stdout aus; Logs gehen nach stderr (HERDR_MCP_LOG_LEVEL=DEBUG für argv-Tracing).

Client-Konfiguration

Claude Code:

claude mcp add herdr -- uvx --from git+https://github.com/aelaguiz/herdr-mcp herdr-mcp

Generisches mcpServers-JSON (Claude Desktop, Cursor, Codex und weitere):

{
  "mcpServers": {
    "herdr": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/aelaguiz/herdr-mcp", "herdr-mcp"],
      "env": {}
    }
  }
}

Stattdessen aus einem lokalen Checkout:

{
  "mcpServers": {
    "herdr": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/herdr-mcp", "herdr-mcp"]
    }
  }
}

Werkzeuge

Pane-IDs sehen aus wie w17:p1, Tab-IDs wie w17:t1, Workspace-IDs wie w17. Agent-Werkzeuge akzeptieren eine Pane-ID oder einen Agenten-Namen. Jedes Werkzeug gibt das geparste result-Objekt aus der herdr-JSON-Hülle zurück; read_pane liefert reinen Text.

Fehler von der CLI (unbekannte Pane, Timeout, toter Socket) kommen als MCP-Werkzeug-Fehler mit Herdrs eigenem Fehlercode und Fast Meldung zurück, damit das Modell sich korrigieren kann.

Sicherheit

Keine Authentifizierung, keine Sandbox, nur lokales stdio. Jeder Client, der diesen Server starten kann, kann beliebige Befehle in deinen Terminal-Panes ausführen und alles auf dem Bildschirm lesen, einschließlich dessen, was eine Agent-Pane zeigt. Verbinde ihn nur mit Clients, denen du auf deiner eigenen Machine vertraust.

Umgebung

D Allges, was sonst noch in der Umgebung steht, wird unverändert durchgereicht; so findet die CLI den richtigen Sitzungs-Socket.

Entwicklung

uv sync
uv run pytest -q

Unit-Tests führen den Server über den In-Memory-Client des SDK gegen ein Stub-herdr-Skript aus, sodass sie nie eine echte Sitzung berühren.