Skip to main content
Glama
M-Baton MCP Relay Server

M-Baton MCP Relay Server

Official
README.md
# M-Baton MCP Relay Server

Web上のAI(ChatGPT・Claude・Gemini等)から、あなたのPCで常駐しているM-BatonへMCPリクエストを中継する軽量サーバーです。

## 仕組み

```
[Web版AI] → [この中継サーバー] → [あなたのPCのM-Baton]
                 ↑ 外向きポーリング接続(PC側から)
```

- PC側は外向きHTTPSのみ(ファイアウォール設定変更不要)
- マニュアル本文・画像は中継サーバーに保存されません(メモリ上を通過するだけ)
- 256bit暗号トークン(channel_token)でユーザーごとに分離

## 特徴

- **データ非保持**:マニュアル本文・画像はディスク・DBに一切保存せず、応答後にメモリから消去
- **ユーザー分離**:SHA-256ハッシュ化されたトークンで厳密に分離
- **サーバー合言葉**:`RELAY_SHARED_SECRET`で不正登録を防止
- **レート制限**:IP単位のブルートフォース防御
- **軽量**:Flask + gunicorn・メモリ上のキューのみ(外部DB不要)

## デプロイ方法

### Google Cloud Run(推奨)

```bash
gcloud run deploy mbaton-relay \
  --source . \
  --region asia-northeast1 \
  --allow-unauthenticated \
  --set-env-vars "RELAY_SHARED_SECRET=あなたの合言葉" \
  --max-instances=1 \
  --concurrency=80
```

> **重要**:`--max-instances=1`は必須です。中継はメモリ上のキューで動くため、複数インスタンスにするとキューが分散して動かなくなります。

### Docker(任意のサーバー)

```bash
docker build -t mbaton-relay .
docker run -d --name mbaton-relay \
  -p 8080:8080 \
  -e RELAY_SHARED_SECRET="あなたの合言葉" \
  --restart unless-stopped \
  mbaton-relay
```

> HTTPSリバースプロキシ(Caddy・nginx・Cloudflare Tunnel等)を前に置いてください。HTTPのまま公開しないでください。

## 環境変数

| 環境変数 | 既定値 | 役割 |
|---|---|---|
| `RELAY_SHARED_SECRET` | (空=チェックしない) | 中継サーバーへの登録を許可するM-Batonを制限する合言葉 |
| `RELAY_RATE_LIMIT_PER_MINUTE` | 120 | IP単位のレート制限(ブルートフォース対策) |
| `RELAY_POLL_WAIT_SECONDS` | 45.0 | ロングポーリングの待機秒数 |
| `RELAY_RPC_TIMEOUT_SECONDS` | 35.0 | PCからの応答を待つ最大秒数 |
| `PORT` | 8080 | リッスンするポート(Cloud Runが自動設定) |

## M-Baton側の設定

中継サーバーをデプロイした後、M-Batonアプリの「設定 > AI・MCP連携」で以下を設定します:

| 項目 | 設定値 |
|---|---|
| AI・MCP連携 | ON |
| 中継サーバーURL | `https://あなたの中継サーバーURL` |
| 中継サーバー合言葉 | デプロイ時に設定した `RELAY_SHARED_SECRET` と同じ値 |

設定後、M-Batonが発行するリモートMCP URL(`https://あなたの中継サーバーURL/mcp/mb_xxxxxxxx`)を、AI側のカスタムMCPサーバーとして登録します。

## セキュリティ

- **`RELAY_SHARED_SECRET`を必ず設定してください**(未設定だと第三者がリクエストを送れます)
- **HTTPS必須**(HTTPのまま公開するとトークンが平文で流れます)
- channel_tokenはあなたのマニュアルにアクセスする鍵です。他人に教えないでください
- トークンが漏れた場合はM-Batonの設定画面で「channel_token再発行」を押せば古いトークンは無効になります

## ライセンス

MIT License - 詳細は [LICENSE](LICENSE) を参照

## 関連リンク

- [M-Baton公式サイト](https://mbaton.com)
- [M-Baton MCP連携ガイド](https://mbaton.com/docs/mcp)