mcp-akiko-proxy

MCP-stdio-Proxy über SSH, der entfernte MCP-Server (gebunden an localhost auf einem Remote-Rechner) als Tools auf dem lokalen Rechner bereitstellt.

Er richtet SSH-Tunnel über Ihren vorhandenen ~/.ssh/config-Host-Alias ein, verbindet sich über streamable-http durch den Tunnel mit den entfernten MCP-Servern und stellt deren Tools aggregiert hinter einem lokalen stdio-MCP-Server bereit.

Standardziele (konfigurierbar):

Sanfte Degradierung

Wenn der Tunnel nicht verfügbar ist oder ein Backend nicht erreichbar ist, verschwinden die Tools dieses Backends aus tools/list (oder ihre Aufrufe geben einen klaren Fehler zurück). Der Proxy läuft weiter und versucht regelmäßig erneut – er stürzt nie ab, weil ein Backend fehlt.

Related MCP server: ssh-chat-mcp

Verwendung

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

Konfiguration (Umgebungsvariablen)

Beispiel: opencode auf einem Macbook mit Blender+QGIS auf der akiko-Box

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

Führen Sie MCP_PROXY_HOST=akiko npx -y github:gbastkowski/mcp-proxy aus – der Host wird aus Ihrer normalen ssh-Konfiguration gelesen, Schlüssel aus Ihrem Agent.

Anforderungen

• Node >= 18

• ssh mit einem konfigurierten Host-Alias für den Remote-Rechner + funktionierende Schlüsselauthentifizierung

• Auf dem Remote: Die Ziel-MCP-Server müssen an 127.0.0.1 gebunden sein (sie sind nicht im Netzwerk exponiert; der SSH-Tunnel ist die einzige Brücke)

Lizenz

MIT