Skip to main content
Glama

mcp-akiko-proxy

SSHを介したMCP stdioプロキシ。リモートマシンのlocalhostにバインドされたリモートMCPサーバーを、ローカルマシンのツールとして公開します。

既存の~/.ssh/configホストエイリアスを使用してSSHトンネルを確立し、トンネル経由でstreamable-httpを介してリモートMCPサーバーに接続し、それらのツールを1つのローカル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 defaults

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

unset

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

Related MCP Connectors

Related MCP Servers

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