mcpgo

Claude Code の MCP を Claude との会話で管理 — 一覧表示、再起動、ラップなど。

Claude Code が動作するすべての環境で動作します。Remote Control など、/mcp が使えない環境でも利用できます。

インストール

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

要件: Node.js ≥ 18

Related MCP server: MCP Server Generator

Remote Control

Claude Code の Remote Control モードでは /mcp にアクセスできません。つまり、リモートで MCP サーバーの一覧表示、再起動、管理ができないということです — mcpgo を使わない限り。

mcpgo 自体が MCP サーバーであるため、Claude Code が動作するすべての場所で利用できます:

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

/mcp の UI は不要です。

できること

信頼性の高い再起動

Claude Code は起動時に作成するパイプを介して stdio MCP サーバーに接続します。サーバーがクラッシュしたり再起動したい場合、Claude Code は自動復旧なしで失敗としてマークします。

mcpgo はラッパーでこれを解決します: Claude Code と MCP の間に常駐する長寿命プロセスです。Claude Code はラッパー（生存し続ける）と通信し、ラッパーは実際のサーバーを子プロセスとして起動します — サーバーが終了すると自動的に再起動します。

ラッピングは任意です — 何もラップせずに、MCP の一覧表示、追加、削除だけに mcpgo を使うこともできます。ラッピングが必要なのは、/mcp に触れずに信頼性の高い再起動を実現したい場合だけです。

MCP ごとの初期設定:

1. wrap_mcp_stdio — 設定内の対象 MCP をラップします

2. Claude Code を再起動（または /mcp で切断 + 再接続）

3. 完了 — いつでも restart_mcp_process を使用できます

設定後:

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

ラッピングを解除したい場合は、unwrap_mcp_stdio を使用して元の設定に戻します。

ツール

プロセス管理

wrap_mcp_stdio

信頼性の高い再起動のために Claude Code の stdio MCP をラップします。

"wrap github"
"wrap postgres"

unwrap_mcp_stdio

ラップされた MCP を元の設定に戻します。

"unwrap github"
"unwrap postgres"

restart_mcp_process

ラップされた MCP の子プロセスを再起動します — ラッパーが自動的に再起動し、Claude Code は接続を維持します。

"restart github"
"restart postgres"

check_mcp_health

MCP が設定されているか、ラップされているか、プロセスが実行中かを確認します。

"check github health"
"is postgres running?"

Codex CLI サポート

wrap_codex_mcp_stdio

~/.codex/config.toml から Codex CLI MCP をラップします。

"wrap my codex mcp called postgres"

restart_codex_mcp_process

ラップされた Codex CLI MCP を再起動します。

"restart the codex postgres"

設定管理

list_all_mcps

設定されているすべての MCP サーバーを一覧表示します。

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

add_mcp

~/.claude.json に新しい MCP サーバーを追加します。

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

remove_mcp

MCP サーバーを削除します。

"remove the my-tool mcp"

configure_mcp

既存の MCP サーバーの設定フィールドを更新します。

"change github's command to python3"

get_mcp_details

特定の MCP の完全な設定詳細を取得します。

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

ラッピングの仕組み

wrap_mcp_stdio "github" を呼び出すと、設定エントリは次のように変わります:

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

から:

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

ラッパーは:

• 元のコマンドを子プロセスとして起動

• 子プロセスの PID を pidfile に書き込む

• 子プロセスが終了すると自動的に再起動（バックオフ付き）

• 厳選された環境変数を子プロセスに渡す（PATH、ロケール、一時ディレクトリ、ホーム、および MCP の宣言された env キー）— Claude Code の完全な環境を継承する代わりに

• SIGTERM、SIGINT、または stdin EOF でクリーンに終了

restart_mcp_process は pidfile を読み取り、子プロセスを終了します。ラッパーが再起動するため、Claude Code は切断を認識しません。

unwrap_mcp_stdio はこれを逆にします — -- 以降の引数から元のコマンドを復元し、pidfile を削除します。

安定したラッパーの場所

MCP をラップすると、mcpgo は wrapper.js を安定したユーザーデータの場所にコピーし、そのパスを ~/.claude.json に書き込みます。これにより、設定は npx キャッシュのクリアや mcpgo のバージョンアップグレード後も存続します — ラッパーが突然消えることはありません。

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

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

既にラップされた MCP に対して wrap_mcp_stdio を再実行すると、ラッパーのコピーがその場で更新されます。

Pidfile の場所

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

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

注意事項

• ラッピングを有効にするには Claude Code の再起動（または手動で /mcp から切断 + 再接続）が必要です — Claude Code は設定をメモリにキャッシュするため

• restart_mcp_process はラップされた MCP で最も効果的です。ラップされていない MCP ではプロセスを終了しますが、/mcp から手動で再接続する必要があります

• リクエスト途中のクラッシュは一時的なプロトコル不整合を引き起こす可能性があります。Claude Code は次のツール呼び出しで回復します

• ラップされた MCP は、Claude Code の完全な環境ではなく、厳選された環境変数（PATH、ロケール、一時ディレクトリ、ホーム、および MCP の宣言された env キー）を受け取ります。以前にラップした MCP にこのデフォルトを適用するには、wrap_mcp_stdio を再実行してください

• list_all_mcps と get_mcp_details はデフォルトで env の値を伏せ字にするため、これらのツールを使って MCP 設定に保存されたシークレットを外部に持ち出すことはできません — 実際に確認する必要がある場合は show_env_values: true を渡してください