mcpgo

Claude Code MCP를 Claude와 대화로 관리하세요 — 목록 보기, 재시작, 래핑 등.

Claude Code가 작동하는 모든 곳에서 작동하며, /mcp를 사용할 수 없는 Remote Control에서도 작동합니다.

설치

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에 접근할 수 없습니다. 즉, mcpgo가 없다면 원격으로 MCP 서버를 나열하거나, 재시작하거나, 관리할 수 없습니다.

mcpgo 자체가 MCP 서버이기 때문에 Claude Code가 있는 모든 곳에서 사용할 수 있습니다:

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

/mcp UI가 필요 없습니다.

기능

안정적인 재시작

Claude Code는 시작 시 생성한 파이프를 통해 stdio MCP 서버에 연결합니다. 서버가 충돌하거나 재시작하려는 경우, Claude Code는 자동 복구 없이 해당 서버를 실패로 표시합니다.

mcpgo는 **래퍼(wrapper)**로 이 문제를 해결합니다: Claude Code와 MCP 사이에 위치하는 장기 실행 프로세스입니다. Claude Code는 래퍼(계속 살아 있음)와 통신하고, 래퍼는 실제 서버를 자식 프로세스로 생성합니다 — 서버가 종료될 때마다 자동으로 다시 생성합니다.

래핑은 선택 사항입니다 — 아무것도 래핑하지 않고 mcpgo를 MCP 목록 보기, 추가, 제거에만 사용할 수 있습니다. 래핑은 /mcp를 건드리지 않고 안정적인 재시작이 필요할 때만 필요합니다.

MCP당 1회 설정:

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에 기록

• 종료 시 자동으로 다시 생성 (백오프 포함)

• Claude Code의 전체 환경을 상속하는 대신, 선별된 환경(PATH, 로케일, 임시, 홈, 그리고 MCP가 선언한 env 키)을 자식에게 전달

• 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를 전달하세요