mcp-akiko-proxy

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

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

默认目标（可配置）：

优雅降级

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

配置（环境变量）

示例：在 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