mcpgo

Gestiona tus MCP de Claude Code hablando con Claude: lista, reinicia, envuelve y más.

Funciona en todos los lugares donde funciona Claude Code, incluido Remote Control donde /mcp no está disponible.

Instalación

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

Requisitos: Node.js ≥ 18

Related MCP server: MCP Server Generator

Remote Control

El modo Remote Control de Claude Code no tiene acceso a /mcp. Eso significa que no puedes listar, reiniciar ni gestionar servidores MCP de forma remota, a menos que tengas mcpgo.

Como mcpgo es en sí mismo un servidor MCP, está disponible en todos los lugares donde lo está Claude Code:

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

No se necesita interfaz /mcp.

Qué hace

Reinicios fiables

Claude Code se conecta a servidores MCP stdio mediante tuberías que crea al iniciarse. Si un servidor falla o quieres reiniciarlo, Claude Code lo marca como fallido sin recuperación automática.

mcpgo resuelve esto con un wrapper: un proceso de larga duración que se sitúa entre Claude Code y tu MCP. Claude Code habla con el wrapper (que permanece activo), y el wrapper lanza el servidor real como hijo, reiniciándolo automáticamente cada vez que se elimina.

El wrapping es opcional: puedes usar mcpgo solo para listar, añadir o eliminar MCP sin envolver nada. El wrapping solo es necesario si quieres reinicios fiables sin tocar /mcp.

Configuración única por MCP:

1. wrap_mcp_stdio — envuelve el MCP objetivo en la configuración

2. Reinicia Claude Code (o desconecta y reconecta mediante /mcp)

3. Listo: usa restart_mcp_process en cualquier momento

Después de la configuración:

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

Si alguna vez quieres deshacer el wrapping, usa unwrap_mcp_stdio para restaurar la configuración original.

Herramientas

Gestión de procesos

wrap_mcp_stdio

Envuelve un MCP stdio de Claude Code para reinicios fiables.

"wrap github"
"wrap postgres"

unwrap_mcp_stdio

Restaura un MCP envuelto a su configuración original.

"unwrap github"
"unwrap postgres"

restart_mcp_process

Reinicia el proceso hijo de un MCP envuelto: el wrapper lo reinicia automáticamente y Claude Code permanece conectado.

"restart github"
"restart postgres"

check_mcp_health

Comprueba si un MCP está configurado, envuelto y si su proceso está en ejecución.

"check github health"
"is postgres running?"

Soporte para Codex CLI

wrap_codex_mcp_stdio

Envuelve un MCP de Codex CLI desde ~/.codex/config.toml.

"wrap my codex mcp called postgres"

restart_codex_mcp_process

Reinicia un MCP de Codex CLI envuelto.

"restart the codex postgres"

Gestión de configuración

list_all_mcps

Lista todos los servidores MCP configurados.

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

add_mcp

Añade un nuevo servidor MCP a ~/.claude.json.

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

remove_mcp

Elimina un servidor MCP.

"remove the my-tool mcp"

configure_mcp

Actualiza los campos de configuración de un servidor MCP existente.

"change github's command to python3"

get_mcp_details

Obtén los detalles completos de configuración de un MCP específico.

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

Cómo funciona el wrapping

Cuando llamas a wrap_mcp_stdio "github", la entrada de configuración cambia de:

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

a:

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

El wrapper:

• Lanza el comando original como hijo

• Escribe el PID del hijo en un pidfile

• Reinicia automáticamente al hijo al salir (con retroceso)

• Pasa un entorno seleccionado al hijo (PATH, locale, temp, home, más las claves env declaradas del MCP) en lugar de heredar el entorno completo de Claude Code

• Sale limpiamente ante SIGTERM, SIGINT o EOF de stdin

restart_mcp_process lee el pidfile y mata al hijo. El wrapper lo reinicia: Claude Code nunca ve una desconexión.

unwrap_mcp_stdio invierte esto: restaura el comando original a partir de los argumentos después de -- y elimina el pidfile.

Ubicación estable del wrapper

Cuando envuelves un MCP, mcpgo copia wrapper.js a una ubicación estable de datos de usuario y escribe esa ruta en ~/.claude.json. Esto significa que la configuración sobrevive a las limpiezas de caché de npx y a las actualizaciones de versión de mcpgo: el wrapper no desaparecerá de debajo de ti.

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

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

Volver a ejecutar wrap_mcp_stdio en un MCP ya envuelto actualiza la copia del wrapper en su lugar.

Ubicaciones de pidfile

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

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

Notas

• El wrapping requiere reiniciar Claude Code (o desconexión y reconexión manual de /mcp) para que surta efecto: Claude Code almacena la configuración en memoria

• restart_mcp_process funciona mejor en MCP envueltos; para los no envueltos, mata el proceso pero tendrás que reconectar manualmente mediante /mcp

• Los fallos a mitad de solicitud pueden causar una breve desincronización del protocolo; Claude Code se recupera en la siguiente llamada a herramienta

• Los MCP envueltos reciben un entorno seleccionado (PATH, locale, temp, home, más las claves env declaradas del MCP) en lugar del entorno completo de Claude Code. Vuelve a ejecutar wrap_mcp_stdio en MCP previamente envueltos para adoptar este valor predeterminado

• list_all_mcps y get_mcp_details ocultan los valores de env por defecto para que las herramientas no puedan usarse para extraer secretos almacenados en configuraciones de MCP: pasa show_env_values: true cuando realmente necesites verlos