mcpgo

Verwalten Sie Ihre Claude Code MCPs, indem Sie mit Claude sprechen – auflisten, neu starten, kapseln und mehr.

Funktioniert überall dort, wo Claude Code funktioniert, einschließlich Remote Control, wo /mcp nicht verfügbar ist.

Installation

npm install -g @exfil/mcpgo
claude mcp add mcpgo --scope user -- mcpgo

Anforderungen: Node.js ≥ 18

Related MCP server: MCP Server Generator

Remote Control

Der Remote-Control-Modus von Claude Code hat keinen Zugriff auf /mcp. Das bedeutet, dass Sie MCP-Server nicht remote auflisten, neu starten oder verwalten können – es sei denn, Sie haben mcpgo.

Da mcpgo selbst ein MCP-Server ist, ist es überall dort verfügbar, wo Claude Code ist:

"list my mcps"
"restart github"
"check postgres health"

Keine /mcp-Benutzeroberfläche erforderlich.

Was es tut

Zuverlässige Neustarts

Claude Code verbindet sich über Pipes, die es beim Start erstellt, mit stdio-MCP-Servern. Wenn ein Server abstürzt oder Sie ihn neu starten möchten, markiert Claude Code ihn als fehlgeschlagen, ohne automatische Wiederherstellung.

mcpgo löst dies mit einem Wrapper: einem langlebigen Prozess, der zwischen Claude Code und Ihrem MCP sitzt. Claude Code spricht mit dem Wrapper (der am Leben bleibt), und der Wrapper startet den echten Server als Kindprozess – und startet ihn automatisch neu, wenn er beendet wird.

Das Umschließen ist optional – Sie können mcpgo nur zum Auflisten, Hinzufügen oder Entfernen von MCPs verwenden, ohne etwas zu umschließen. Umschließen ist nur erforderlich, wenn Sie zuverlässige Neustarts ohne Eingriff in /mcp wünschen.

Einmalige Einrichtung pro MCP:

1. wrap_mcp_stdio – umschließt das Ziel-MCP in der Konfiguration

2. Starten Sie Claude Code neu (oder trennen und verbinden Sie sich über /mcp neu)

3. Fertig – verwenden Sie restart_mcp_process jederzeit

Nach der Einrichtung:

"restart github"     → instant, wrapper auto-respawns the child, Claude Code stays connected
"restart postgres"        → same

Wenn Sie das Umschließen rückgängig machen möchten, verwenden Sie unwrap_mcp_stdio, um die ursprüngliche Konfiguration wiederherzustellen.

Werkzeuge

Prozessverwaltung

wrap_mcp_stdio

Umschließen Sie ein Claude-Code-stdio-MCP für zuverlässige Neustarts.

"wrap github"
"wrap postgres"

unwrap_mcp_stdio

Stellen Sie ein umschlossenes MCP wieder auf seine ursprüngliche Konfiguration zurück.

"unwrap github"
"unwrap postgres"

restart_mcp_process

Starten Sie den Kindprozess eines umschlossenen MCP neu – der Wrapper startet ihn automatisch neu, Claude Code bleibt verbunden.

"restart github"
"restart postgres"

check_mcp_health

Prüfen Sie, ob ein MCP konfiguriert, umschlossen und sein Prozess läuft.

"check github health"
"is postgres running?"

Codex-CLI-Unterstützung

wrap_codex_mcp_stdio

Umschließen Sie ein Codex-CLI-MCP aus ~/.codex/config.toml.

"wrap my codex mcp called postgres"

restart_codex_mcp_process

Starten Sie ein umschlossenes Codex-CLI-MCP neu.

"restart the codex postgres"

Konfigurationsverwaltung

list_all_mcps

Alle konfigurierten MCP-Server auflisten.

"list my mcps"
"what mcps do I have?"

add_mcp

Einen neuen MCP-Server zu ~/.claude.json hinzufügen.

"add an mcp called my-tool that runs python server.py"

remove_mcp

Einen MCP-Server entfernen.

"remove the my-tool mcp"

configure_mcp

Aktualisieren Sie die Konfigurationsfelder eines vorhandenen MCP-Servers.

"change github's command to python3"

get_mcp_details

Vollständige Konfigurationsdetails für ein bestimmtes MCP abrufen.

"show me the github config"
"get details for postgres"

Wie das Umschließen funktioniert

Wenn Sie wrap_mcp_stdio "github" aufrufen, ändert sich der Konfigurationseintrag von:

{ "command": "python", "args": ["server.py"] }

zu:

{
  "command": "node",
  "args": [
    "/path/to/wrapper.js",
    "--name", "github",
    "--pidfile", "...",
    "--env-allowlist", "PATH,Path,PATHEXT,HOME,USERPROFILE,SystemRoot,...",
    "--",
    "python", "server.py"
  ]
}

Der Wrapper:

• Startet den ursprünglichen Befehl als Kindprozess

• Schreibt die PID des Kindprozesses in eine Pidfile

• Startet den Kindprozess beim Beenden automatisch neu (mit Backoff)

• Übergibt dem Kindprozess eine kuratierte Umgebung (PATH, Locale, Temp, Home, plus die deklarierten env-Schlüssel des MCP) anstatt die vollständige Umgebung von Claude Code zu erben

• Beendet sich sauber bei SIGTERM, SIGINT oder stdin-EOF

restart_mcp_process liest die Pidfile und beendet den Kindprozess. Der Wrapper startet ihn neu – Claude Code sieht nie eine Trennung.

unwrap_mcp_stdio kehrt dies um – es stellt den ursprünglichen Befehl aus den Argumenten nach -- wieder her und entfernt die Pidfile.

Stabiler Speicherort des Wrappers

Wenn Sie ein MCP umschließen, kopiert mcpgo wrapper.js an einen stabilen Benutzerdatenspeicherort und schreibt diesen Pfad in ~/.claude.json. Das bedeutet, dass die Konfiguration npx-Cache-Löschungen und mcpgo-Versionsupgrades übersteht – der Wrapper verschwindet nicht unter Ihnen.

• Windows: %LOCALAPPDATA%\mcpgo\wrapper.js

• Linux/macOS: ~/.mcpgo/wrapper.js

Wenn Sie wrap_mcp_stdio erneut auf einem bereits umschlossenen MCP ausführen, wird die Wrapper-Kopie an Ort und Stelle aktualisiert.

Pidfile-Speicherorte

• Windows: %LOCALAPPDATA%\mcpgo\pids\<name>.pid

• Linux/macOS: $TMPDIR/mcpgo/pids/<name>.pid

Hinweise

• Das Umschließen erfordert einen Neustart von Claude Code (oder manuelles Trennen + erneutes Verbinden über /mcp), um wirksam zu werden – Claude Code speichert die Konfiguration im Arbeitsspeicher

• restart_mcp_process funktioniert am besten bei umschlossenen MCPs; bei nicht umschlossenen beendet es den Prozess, aber Sie müssen sich manuell über /mcp neu verbinden

• Abstürze während einer Anfrage können eine kurze Protokoll-Desynchronisierung verursachen; Claude Code erholt sich beim nächsten Tool-Aufruf

• Umschlossene MCPs erhalten eine kuratierte Umgebung (PATH, Locale, Temp, Home, plus die deklarierten env-Schlüssel des MCP) anstelle der vollständigen Claude-Code-Umgebung. Führen Sie wrap_mcp_stdio erneut auf zuvor umschlossenen MCPs aus, um diese Standardeinstellung zu übernehmen

• list_all_mcps und get_mcp_details schwärzen env-Werte standardmäßig, damit die Werkzeuge nicht zum Exfiltrieren von Geheimnissen aus MCP-Konfigurationen verwendet werden können – übergeben Sie show_env_values: true, wenn Sie sie tatsächlich sehen müssen