Skip to main content
Glama
deenesjakoruzh
gbastkowski

mcp-proxy

by gbastkowski
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

mcp-akiko-proxy

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

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

기본 대상(구성 가능):

name

local port

remote url

exposes

blender

8001

http://127.0.0.1:8001/

Blender MCP (원격의 blender-mcp 데몬)

qgis

8000

http://127.0.0.1:8000/mcp

QGIS MCP (원격의 qgis-mcp 데몬)

원활한 저하(Graceful degradation)

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

Related MCP server: Bonsai MCP

사용법

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

구성 (환경 변수)

var

default

purpose

MCP_PROXY_HOST

akiko

~/.ssh/config의 ssh 호스트 별칭

MCP_PROXY_TUNNELS

blender+qgis 기본값

JSON [{ name, localPort, remotePort, url }]

MCP_PROXY_TUNNEL_RETRY_MS

15000

죽은 백엔드에 대한 재연결/재시도 간격

MCP_PROXY_CONNECT_TIMEOUT_MS

10000

터널/백엔드 포트 대기 시간

MCP_PROXY_SSH_TIMEOUT_MS

5000

ssh ConnectTimeout

MCP_PROXY_NO_TUNNEL

설정 안 됨

truthy: ssh 건너뛰고 localhost에 직접 연결 (테스트용)

예시: 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

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Docker MCP

    Isak-Landin
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables remote Docker management over SSH via a local MCP server, providing tools to manage containers, images, Compose, and system resources.
    1
    GPL 3.0

  • Bonsai MCP

    Show2Instruct
    A
    license
    A
    quality
    B
    maintenance
    Connects MCP clients to a local Blender + Bonsai (BlenderBIM) session for scene inspection, IFC project querying, viewport screenshots, and executing Python code in Blender.
    8
    8
    MIT

  • AI Ops MCP

    Finn-Aigc
    A
    license
    Not graded
    quality
    B
    maintenance
    Local SSH credential broker and stdio MCP server that enables AI clients to perform SSH and SFTP operations via stable server_id aliases without exposing passwords, private keys, or passphrases.
    7 npm
    1
    MIT

  • blender-server-mcp-docker

    BATTLEHAWK00
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables remote control of Blender through MCP, allowing code execution, scene manipulation, rendering, and file transfer in a containerized environment.
    1
    -