mcp-akiko-proxy

Proxy stdio MCP sobre SSH, que expone servidores MCP remotos (vinculados a localhost en una máquina remota) como herramientas en la máquina local.

Establece túneles SSH usando tu alias de host existente en ~/.ssh/config, se conecta a los servidores MCP remotos a través de streamable-http mediante el túnel, y expone sus herramientas agregadas detrás de un único servidor MCP stdio local.

Objetivos predeterminados (configurables):

Degradación elegante

Si el túnel está caído o un backend es inalcanzable, las herramientas de ese backend desaparecen de tools/list (o sus llamadas devuelven un error claro). El proxy sigue ejecutándose y reintenta periódicamente — nunca se bloquea porque falte un backend.

Related MCP server: Bonsai MCP

Uso

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

Configuración (variables de entorno)

Ejemplo: opencode en un Macbook usando Blender+QGIS en la máquina akiko

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

Ejecuta MCP_PROXY_HOST=akiko npx -y github:gbastkowski/mcp-proxy — el host se lee de tu configuración ssh normal, las claves de tu agente.

Requisitos

• Node >= 18

• ssh con un alias de host configurado para la máquina remota + autenticación por clave funcional

• En el remoto: los servidores MCP objetivo vinculados a 127.0.0.1 (no están expuestos a la red; el túnel SSH es el único puente)

Licencia

MIT