Octopus MCP Proxy

English | 日本語

HTTP/stdio 対応の MCP サーバー。API/MCP 中継機能とユーザー別権限管理を備えた Web 管理画面付き。

機能

• MCP プロトコル対応: HTTP と stdio の両方をサポート
• 中継機能: API および MCP サーバーへの中継
• 権限管理: ユーザーごとの Tool 使用権限制御
• Web 管理画面: サービス、Capability、ユーザーの管理
• Bearer トークン認証: ユーザー別のトークン発行

MCP プロトコル仕様対応

仕様バージョン	対応状況
2026-07-28 (最新)	✅ 対応済み — ステートレスリクエスト、server/discover
2024-11-05 (旧)	✅ 後方互換として継続サポート

2026-07-28 対応内容

• ステートレスリクエスト: initialize ハンドシェイクや Mcp-Session-Id なしで tools/list / tools/call などを直接呼び出せます。
• server/discover: セッション不要のケーパビリティ検出エンドポイント。protocolVersions: ["2026-07-28", "2024-11-05"] を返します。
• 後方互換: Mcp-Session-Id を送る旧仕様クライアントの initialize → セッションフローは引き続き動作します。不正なセッション ID を送った場合のみ 400 を返します。

コンテナ構成

Octopus MCP Proxy は次のコンテナで構成されます（web と mcp は同一イメージ）。

• caddy: リバースプロキシ / TLS（パスで web と mcp に振り分け）
• web: 管理画面 + REST API（起動時に DB マイグレーションを実行）
• mcp: MCP エンドポイント（複数レプリカ / 別ホストにスケール可能）
• redis: 旧仕様の Streamable HTTP セッションの共有ストア
• db: PostgreSQL

1台運用（全部入り）も複数台運用（WEB/MCP/Redis を別サーバに分散）も同じ compose 定義で動きます。 旧仕様の MCP セッションは REDIS_URL があれば Redis で共有され、未設定ならプロセス内メモリにフォールバックします。 詳細は スケーリング・コンテナ構成 を参照してください。

起動方法

開発環境（デフォルト）

# Docker Composeで起動
docker compose up -d

# ログ確認
docker compose logs -f

# 停止
docker compose down

開発環境では Flask 開発サーバーが起動し、コード変更時に自動リロードされます。

本番環境

# Gunicornで起動
FLASK_ENV=production docker compose up -d

または .env ファイルで設定：

FLASK_ENV=production

本番環境では Gunicorn が起動し、マルチプロセスで安定した動作を提供します。

ログレベルの設定

環境変数 LOG_LEVEL でログレベルを制御できます：

# DEBUGレベルで起動（詳細なログを出力）
LOG_LEVEL=DEBUG docker compose up -d

# INFOレベル（デフォルト）
LOG_LEVEL=INFO docker compose up -d

利用可能なログレベル：

• DEBUG: 詳細なデバッグ情報
• INFO: 一般的な情報メッセージ（デフォルト）
• WARNING: 警告メッセージ
• ERROR: エラーメッセージ
• CRITICAL: 重大なエラー

.env ファイルで設定することも可能：

LOG_LEVEL=DEBUG

アクセス

Docker Compose で起動した場合（推奨）

Caddy がリバースプロキシとして 443/80 番ポートを受け、web/mcp コンテナの 5000 番は ホストに公開されません。ポート番号なしの https:// でアクセスしてください。

• Web 管理画面: https://localhost/
• MCP サービス（サブドメイン方式）: https://<identifier>.lvh.me/mcp （lvh.me は常に 127.0.0.1 を指す公開DNSなので、追加設定なしでサブドメインが使えます）

証明書は Caddy が自動生成する自己署名証明書（tls internal）です。ブラウザに 「この接続は保護されていません」という警告が出ますが、ローカル開発では想定どおりの動作です。 警告を消したい場合は スケーリング・コンテナ構成 の手順で Caddy のローカル CA をOSに信頼させてください。

• デフォルト管理者
  • ID: admin
  • パスワード: admin

Docker を使わず python run.py で直接起動した場合

Flask 開発サーバーがそのままポート 5000 で起動するので、TLS なしでアクセスします。

• Web 管理画面: http://localhost:5000/
• MCP サービス（サブドメイン方式）: http://<identifier>.lvh.me:5000/mcp

⚠️ セキュリティ警告

• 本番環境では必ず認証情報を変更してください
• 環境変数 ADMIN_USERNAME と ADMIN_PASSWORD で上書き可能です
• デフォルト認証情報はデモ・検証用です（Oracle の scott/tiger のような位置づけ）

環境変数での認証情報変更：

# docker-compose.yml または .env
environment:
  ADMIN_USERNAME: your_secure_username
  ADMIN_PASSWORD: your_secure_password

注意: 管理画面はパス（/dashboard 等）で振り分けられるため、https://localhost/ ・ https://lvh.me/ ・https://admin.lvh.me/ のどのホスト名でアクセスしても同じ管理画面が 表示されます。MCP サービス側だけが、サブドメイン（<identifier>.lvh.me）で対象サービスを 区別します。

セキュリティ機能

ブルートフォース攻撃対策

管理画面ログインは IP アドレスベースのレート制限機能を備えています：

• デフォルト設定: 5 回の失敗で 30 分間ロック
• ログ記録: 全ログイン試行（成功/失敗）を記録
• 手動ロック解除: 管理画面から IP アドレスのロックを解除可能

監査ログ機能

すべての管理者操作が自動的に記録されます：

• ログイン履歴: ユーザー名、IP アドレス、成功/失敗、タイムスタンプ
• CRUD 操作履歴: MCP サービス、アプリ、Capability、アカウント、権限の作成・更新・削除
• 変更差分: 操作前後の値を JSON 形式で記録
• CSV エクスポート: 監査レポート用に CSV 出力可能

監査ログ API:

• GET /api/admin/login-logs - ログイン履歴取得
• GET /api/admin/login-logs/export - ログイン履歴 CSV 出力
• GET /api/admin/action-logs - 操作履歴取得
• GET /api/admin/action-logs/export - 操作履歴 CSV 出力
• POST /api/admin/unlock-account - IP ロック解除
• GET /api/admin/locked-ips - ロック中 IP 一覧

セキュリティ設定

AdminSettings で以下の設定をカスタマイズ可能：

• login_max_attempts: ログイン試行上限（デフォルト: 5）
• login_lock_duration_minutes: ロック時間（デフォルト: 30 分）
• audit_log_retention_days: 監査ログ保持期間（デフォルト: 365 日）

管理画面構成

ログイン画面

• 管理者認証

サービス管理

• サービス一覧表示
• サービス新規登録 (サブドメイン、共通ヘッダー設定)
• サービス詳細/編集
• Capability 管理

Capability 管理

• Capability 一覧
• Capability 登録 (API/MCP 選択、URL、ヘッダー、ボディ設定)
• Capability 編集/削除

ユーザー管理

• ユーザー一覧
• ユーザー登録 (ログイン ID、パスワード)
• ユーザー詳細 (Bearer トークン表示)
• ユーザー情報編集/削除

MCP クライアント接続

以下は Docker Compose 起動時 (Caddy 経由、https://・ポート番号なし) のURLです。 Docker を使わず python run.py で直接起動した場合は http:// + :5000 を使ってください (例: http://myservice.lvh.me:5000/mcp)。自己署名証明書のため、curl には -k (証明書検証スキップ) が必要です。

サブドメインベースのアクセス (推奨)

1. Capabilities 取得 (GET リクエスト)

# lvh.me ドメインを使用 (ローカル開発用、常に127.0.0.1を指す)
curl -k -H "Authorization: Bearer YOUR_TOKEN" \
  https://myservice.lvh.me/mcp

# または subdomain パラメータを使用
curl -k -H "Authorization: Bearer YOUR_TOKEN" \
  https://localhost/mcp?subdomain=myservice

レスポンス例:

{
  "capabilities": {
    "tools": [
      {
        "name": "get_weather",
        "description": "Get current weather information",
        "inputSchema": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string",
              "description": "Parameter: city"
            }
          }
        }
      }
    ]
  },
  "serverInfo": {
    "name": "Weather Service",
    "version": "1.0.0"
  }
}

This is the beginning of the README. Read the rest at the original. Read the full README ↗