Dify 1.13 HTTP MCP 会議室予約モック

認証サーバーなしでDify 1.13の静的Authorizationヘッダーで会議室予約MCPを検証するプロジェクトです。

Dify 1.13 ── Bearer <고정 JWT> ──> MCP 서버 ── 내부 API 키 ──> 회의실 API

現在の範囲では、JWTのname=difyは実際のユーザー名ではなく、固定サービス識別子の役割のみを果たします。各環境でトークンを直接発行し、同じトークンをDifyヘッダーとMCPサーバーのMCP_STATIC_TOKENに登録する必要があります。

詳細な手順は静的トークン連携ガイドを参照してください。

提供機能

• 会議室一覧の取得

• 会議室の予約と時間重複の防止

• 固定サービスの予約一覧の取得

• トークンなし・不一致・期限切れ・name欠落時にHTTP 401

• 予約成功時にdify님 예약이 완료되었습니다.を返却

Related MCP server: Boma MCP

クイックスタート

Dockerのインストール手順はこのドキュメントでは扱いません。

cp .env.example .env

docker compose run --rm --no-deps mcp-server \
  python scripts/mint_dev_token.py

出力されたJWTを.envに登録します。

MCP_STATIC_TOKEN=eyJ...

サーバーを起動します。

docker compose up -d --build --force-recreate
docker compose ps

サービスアドレス:

• MCP: http://localhost:8001/mcp

• 会議室APIステータス: http://localhost:8000/health

Difyが別のサーバーにある場合は、localhostの代わりにDifyからアクセス可能なHTTPS URLをMCP_PUBLIC_URLとDify MCP設定に同じように登録します。

Dify 1.13設定

静的ヘッダーなので、Difyユーザーが変わってもJWTとname=difyは変わりません。

主要ファイル

テスト

PYTHONPATH=. uv run --isolated --extra test pytest -q

Docker E2E:

docker compose up -d --build --force-recreate
docker compose exec -T mcp-server python scripts/e2e_dify_legacy_client.py

モックの制限

• JWT署名を認証サーバーの公開鍵で検証しません。

• MCPサーバーの.envに固定されたトークン文字列1つのみ許可します。

• ユーザーごとの身元を区別できません。

• 予約データはコンテナ再作成時に初期化されます。

• 本番移行時には認証サーバー、署名検証、短い有効期限、キーローテーション、ユーザー別トークン配信が必要です。