Skip to main content
Glama
deenesjakoruzh
gbastkowski

mcp-proxy

by gbastkowski
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

mcp-akiko-proxy

通过 SSH 的 MCP stdio 代理，将远程 MCP 服务器（绑定在远程机器的 localhost 上）作为工具暴露到本地机器。

使用你现有的 ~/.ssh/config 主机别名建立 SSH 隧道，通过隧道以 streamable-http 方式连接到远程 MCP 服务器，并将它们的工具聚合在一个本地 stdio MCP 服务器后面暴露出来。

默认目标（可配置）：

名称

本地端口

远程 URL

暴露内容

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 守护进程）

优雅降级

如果隧道断开或某个后端不可达，该后端的工具会从 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

配置（环境变量）

变量

默认值

用途

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

未设置

为真：跳过 ssh，直接连接 localhost（测试用）

示例：在 Macbook 上使用 opencode，通过 akiko 机器上的 Blender+QGIS

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

运行 MCP_PROXY_HOST=akiko npx -y github:gbastkowski/mcp-proxy —— 主机名从你常规的 ssh 配置中读取，密钥来自你的 agent。

要求

  • 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
    -