M-Baton MCP Relay Server
OfficialREADME.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)