# 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 互換の形に近づけるため、必ず次の形を返します:
```json
{
"content": [
{ "type": "text", "text": "<JSON文字列>" }
]
}
```
`text` フィールド内に、実際の JSON オブジェクトを文字列化したものが入ります。
## セットアップ
リポジトリのルート (`ghostfolio`) で依存をインストールします。
```powershell
cd ssh-mcp-remote
npm install
```
## 起動方法
```powershell
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 ツール (ダミー)
```bash
curl -X POST http://localhost:8787/query \
-H "Content-Type: application/json" \
-d '{
"tool": "search",
"query": "ssh"
}'
```
返り値は `ssh` ツール 1 件だけを含むダミーのレスポンスです。
### fetch ツール (ダミー)
```bash
curl -X POST http://localhost:8787/query \
-H "Content-Type: application/json" \
-d '{
"tool": "fetch",
"id": "ssh"
}'
```
`search` と同様のダミー応答を返します。
### ssh.exec ツール
```bash
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` も利用可能です:
```bash
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 文字列が入ります:
```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`
## 推奨コマンドまとめ
```bash
# セットアップ
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 側で扱えるようになります。