mcpgo

Управляйте MCP-серверами Claude Code, общаясь с 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

В режиме Remote Control у Claude Code нет доступа к /mcp. Это значит, что вы не можете удалённо перечислять, перезапускать или управлять MCP-серверами — если только у вас нет mcpgo.

Поскольку mcpgo сам является MCP-сервером, он доступен везде, где есть Claude Code:

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

Интерфейс /mcp не нужен.

Что он делает

Надёжные перезапуски

Claude Code подключается к stdio MCP-серверам через каналы, которые создаёт при запуске. Если сервер падает или вы хотите его перезапустить, Claude Code помечает его как сбойный без автоматического восстановления.

mcpgo решает эту проблему с помощью обёртки: долгоживущего процесса, который находится между Claude Code и вашим MCP. Claude Code общается с обёрткой (которая остаётся активной), а обёртка запускает реальный сервер как дочерний процесс — автоматически перезапуская его при завершении.

Обёртка необязательна — вы можете использовать mcpgo только для перечисления, добавления или удаления MCP без оборачивания чего-либо. Обёртка нужна только в том случае, если вы хотите надёжных перезапусков без обращения к /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

Оборачивает stdio MCP Claude Code для надёжных перезапусков.

"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

Оборачивает MCP Codex CLI из ~/.codex/config.toml.

"wrap my codex mcp called postgres"

restart_codex_mcp_process

Перезапускает обёрнутый MCP Codex CLI.

"restart the codex postgres"

Управление конфигурацией

list_all_mcps

Перечисляет все настроенные MCP-серверы.

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

add_mcp

Добавляет новый MCP-сервер в ~/.claude.json.

"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, локаль, temp, home, а также объявленные ключи env MCP) вместо наследования полного окружения Claude Code

• Корректно завершает работу по SIGTERM, SIGINT или при закрытии stdin

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

Повторный запуск wrap_mcp_stdio на уже обёрнутом MCP обновляет копию обёртки на месте.

Расположение pidfile

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

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

Примечания

• Для применения обёртки требуется перезапуск Claude Code (или ручное отключение и повторное подключение через /mcp) — Claude Code кэширует конфигурацию в памяти

• restart_mcp_process лучше всего работает с обёрнутыми MCP; для необёрнутых он завершает процесс, но вам придётся вручную переподключиться через /mcp

• Сбои во время запроса могут вызвать кратковременную рассинхронизацию протокола; Claude Code восстанавливается при следующем вызове инструмента

• Обёрнутые MCP получают подобранное окружение (PATH, локаль, temp, home, плюс объявленные ключи env MCP), а не полное окружение Claude Code. Повторно запустите wrap_mcp_stdio на ранее обёрнутых MCP, чтобы применить это значение по умолчанию

• list_all_mcps и get_mcp_details по умолчанию скрывают значения env, чтобы инструменты нельзя было использовать для вывода секретов, хранящихся в конфигурациях MCP — передайте show_env_values: true, когда вам действительно нужно их увидеть