ssh-mcp-remote

Remote MCP-style HTTP+SSE server that exposes simple tools including ssh.exec for executing commands on remote hosts over SSH.

概要

• Node.js + Express による HTTP サーバー

• MCP Remote Connector から利用できるような形で、以下の 2 エンドポイントを提供します:

  • GET /sse : サーバーからのイベントを受け取るための SSE ストリーム
  • POST /query: MCP 風のツール呼び出し (search, fetch, ssh.exec)

• レスポンスは MCP 互換の形に近づけるため、必ず次の形を返します:

  {
    "content": [
      { "type": "text", "text": "<JSON文字列>" }
    ]
  }
  

  text フィールド内に、実際の JSON オブジェクトを文字列化したものが入ります。

セットアップ

リポジトリのルート (ghostfolio) で依存をインストールします。

cd ssh-mcp-remote
npm install

起動方法

cd ssh-mcp-remote
npm start

デフォルトではポート 8787 で起動します。Replit や Render などのホスティング環境では、環境変数 PORT が自動的に付与されるため、それを利用してリッスンします。

起動後:

• http://localhost:8787/ : ヘルスチェック用の簡単な JSON レスポンス
• http://localhost:8787/sse: SSE ストリーム (ブラウザや MCP Remote Connector が接続)
• POST http://localhost:8787/query: MCP 風ツール呼び出し

/query の使い方

search ツール (ダミー)

curl -X POST http://localhost:8787/query \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "search",
    "query": "ssh"
  }'

返り値は ssh ツール 1 件だけを含むダミーのレスポンスです。

fetch ツール (ダミー)

curl -X POST http://localhost:8787/query \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "fetch",
    "id": "ssh"
  }'

search と同様のダミー応答を返します。

ssh.exec ツール

curl -X POST http://localhost:8787/query \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "ssh.exec",
    "args": {
      "host": "192.168.0.x",
      "user": "mizuki",
      "password": "your-password",
      "command": "ls -la"
    }
  }'

または username や privateKey も利用可能です:

curl -X POST http://localhost:8787/query \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "ssh.exec",
    "args": {
      "host": "192.168.0.x",
      "username": "mizuki",
      "privateKey": "C:/Users/you/.ssh/id_rsa",
      "command": "uname -a"
    }
  }'

レスポンスの content[0].text 内には、次のような JSON 文字列が入ります:

{
  "host": "192.168.0.x",
  "user": "mizuki",
  "command": "ls -la",
  "stdout": "...",
  "stderr": "...",
  "code": 0,
  "error": null
}

同時に、SSE に接続しているクライアントには type: "ssh.exec.result" のイベントとして同じ内容が PUSH されます。

ChatGPT MCP Remote Connector への登録例

実際の UI や設定方法は ChatGPT のバージョンによって異なります。ここでは概念的な例を示します。

• Server URL (ローカル): http://localhost:8787
• SSE Endpoint: /sse
• Query Endpoint: /query

Remote MCP Connector の設定画面が以下のような項目を要求する場合:

• Base URL: http://localhost:8787
• SSE Path: /sse
• Query Path: /query

と設定すれば、このサーバーが Remote MCP として機能します。

クラウド (Replit / Render) にデプロイした場合の URL 例

Replit や Render にこのプロジェクトをデプロイした場合、ベース URL は以下のようになります。

• Base URL (Render): https://ssh-mcp-remote.onrender.com （サービス名に応じて変わります）
• Base URL (Replit): https://your-repl-name.your-username.repl.co
• SSE Path: /sse
• Query Path: /query

ChatGPT MCP Remote Connector 側では、上記の Base URL とパスを指定してください。

例: Render に ssh-mcp-remote という名前でデプロイした場合:

• Base URL: https://ssh-mcp-remote.onrender.com
• SSE Path: /sse
• Query Path: /query

推奨コマンドまとめ

# セットアップ
cd ssh-mcp-remote
npm install

# 起動
npm start

# 動作確認 (例: ssh.exec)
curl -X POST http://localhost:8787/query \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "ssh.exec",
    "args": {
      "host": "192.168.0.x",
      "user": "mizuki",
      "password": "your-password",
      "command": "ls -la"
    }
  }'

この構成を元に、ChatGPT MCP Remote Connector から ssh.exec を呼び出せば、NAS や Linux/VPS 上でコマンドを実行し、その結果を ChatGPT 側で扱えるようになります。