mcp-akiko-proxy

SSH를 통한 MCP stdio 프록시로, 원격 머신의 localhost에 바인딩된 원격 MCP 서버를 로컬 머신의 도구로 노출합니다.

기존 ~/.ssh/config 호스트 별칭을 사용하여 SSH 터널을 설정하고, 터널을 통해 streamable-http로 원격 MCP 서버에 연결한 뒤, 해당 도구들을 하나의 로컬 stdio MCP 서버 뒤에 집계하여 노출합니다.

기본 대상(구성 가능):

원활한 저하(Graceful degradation)

터널이 다운되었거나 백엔드에 연결할 수 없는 경우, 해당 백엔드의 도구는 tools/list에서 사라지거나(또는 해당 호출이 명확한 오류를 반환)합니다. 프록시는 계속 실행되며 주기적으로 재시도합니다. 백엔드가 없어도 절대 크래시되지 않습니다.

Related MCP server: ssh-chat-mcp

사용법

# run (stdio; opencode/claude/any MCP client will spawn it):
npx -y github:gbastkowski/mcp-proxy
# or clone + npm install + npm start

구성 (환경 변수)

예시: akiko 박스의 Blender+QGIS를 사용하는 Macbook의 opencode

{
  "mcp": {
    "akiko": {
      "type": "local",
      "command": ["npx", "-y", "github:gbastkowski/mcp-proxy"]
    }
  }
}

MCP_PROXY_HOST=akiko npx -y github:gbastkowski/mcp-proxy 실행 — 호스트는 일반 ssh 구성에서 읽어오며, 키는 에이전트에서 가져옵니다.

요구 사항

• Node >= 18

• 원격 머신에 대한 호스트 별칭이 구성된 ssh + 작동하는 키 인증

• 원격: 대상 MCP 서버가 127.0.0.1에 바인딩되어 있어야 함 (네트워크에 노출되지 않음; SSH 터널이 유일한 연결 경로)

라이선스

MIT