Paxaver MCP Server

Paxaver スクールコミュニティプラットフォーム向けの AI 向けアダプター。 Cloudflare Workers 上で Model Context Protocol (MCP) を実装し、RS256 JWT 検証、ケイパビリティ優先の認可、Streamable HTTP トランスポートを備えています。

これは何か

Paxaver MCP サーバーは、AI アシスタント（ChatGPT、Claude、Perplexity、および MCP 互換クライアント）が Paxaver ユーザーに代わって行動できるようにします。ランチメニューの確認、 ランチの注文、ウォレットへのチャージ、募金イベントへの登録、学校への寄付、 ボランティア、そして学校管理者向けには、レストラン、メニュー項目、イベント、 日次注文の管理などが可能です。

これは薄いアダプターです。ビジネスロジックは含まれておらず、データベース、 Stripe、メールに直接アクセスすることはありません。すべてのアクションは、Cloudflare の サービスバインディング（同一リージョン、パブリックネットワークを経由しない）を介して プライベートな Paxaver バックエンド API に委任されます。MCP サーバーの唯一の責務は次のとおりです。

• MCP プロトコル処理（JSON-RPC 2.0、Streamable HTTP）

• 中央集権型 Paxaver 認証ワーカーからの JWKS による RS256 JWT 検証

• ツールごとのケイパビリティポリシーとロールゲーティング

• サニタイズされ、ユーザーにとって安全なエラー変換

認証は Paxaver 認証ワーカー（auth.paxaver.com）によって処理され、OAuth 2.0 / OIDC 認可サーバーとして機能します。MCP サーバーは結果の RS256 JWT を検証し、バックエンドに転送します。 MCP サーバー自体は認可サーバーではありません。

Related MCP server: IIITH Mess MCP

アーキテクチャ

┌───────────────┐     MCP (Streamable HTTP)      ┌──────────────────────┐
│   AI Client   │ ─────────────────────────────▶ │   Paxaver MCP Worker │
│ ChatGPT/Claude│ ◀───────────────────────────── │  (this repo)         │
│  /Perplexity  │     RS256 JWT + JSON-RPC 2.0   │  Hono + jose         │
└───────────────┘                                └──────────┬───────────┘
                                                            │
                                          Cloudflare service binding
                                          (PAXAVER_API, same region)
                                                            │
                                                            ▼
                                                 ┌──────────────────────┐
                                                 │  Paxaver API Worker  │
                                                 │  (private backend)   │
                                                 │  D1 · Stripe · SES   │
                                                 └──────────────────────┘

MCP ワーカーは D1、Stripe、SES に決してバインドしません。サービスバインディングは、 バックエンドが内部呼び出しとして信頼する短命 JWT（TTL 120 秒、オーディエンス paxaver-internal）を 運びますが、アクションは認証済み Paxaver ユーザーに帰属させます。全体像については docs/architecture.md を参照してください。

クイックスタート

インストール

npm install @paxaver/mcp

ローカル開発

# 1. Install dependencies (Node >= 22)
npm install

# 2. Configure local secrets
cp .dev.vars.example .dev.vars   # then fill in JWT_SECRET, OAUTH_STATE_SECRET, ...

# 3. Run the worker locally (Miniflare)
npm run dev

# 4. Typecheck, lint, and test
npm run typecheck
npm run lint
npm test

ローカル開発サーバーは http://localhost:8787 で起動します。ディスカバリーエンドポイントは /.well-known/ 配下にあり、MCP エンドポイントは POST /mcp です。

注: PAXAVER_API サービスバインディングがないローカル開発では、 API_BASE_URL（デフォルト http://localhost:8787）に対する認証付き HTTPS にフォールバックします。 統合テストを完全に行うには、Paxaver バックエンドワーカーをローカルで実行し、 API_BASE_URL をそのワーカーに向けてください。

デプロイ

2 つの環境があり、それぞれが独自のカスタムドメインを持つ別々のワーカーです。

本番ワーカーは単一のエンドポイント（mcp.paxaver.com）で CA と US の両方のユーザーにサービスを提供します。 ユーザーのリージョンは JWT の tenant_id クレームから解決され、ワーカーはサービスバインディング （PAXAVER_API_CA、PAXAVER_API_US）を介して正しいリージョンのバックエンドにルーティングします。 通貨は MCP エンドポイントではなく、ユーザーの学校によって決定されます。

npm run deploy:staging   # wrangler deploy --env staging
npm run deploy:prod      # wrangler deploy --env production

シークレットは wrangler secret put --env production で設定する必要があります: JWT_SECRET、OAUTH_STATE_SECRET、GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET、 CHATGPT_VERIFY_TOKEN。詳細は docs/deployment.md を参照してください。

ツール

サーバーは 6 つのカテゴリにグループ化された 31 のツールを公開します。tools/list での可視性は 呼び出し元のロールによってフィルタリングされ、すべての呼び出しはディスパッチ前に再認可され、 バックエンドはデータレベルのアクセスを再チェックします（多層防御）。

金融および破壊的なツールにはラベルが付けられ、ユーザーの確認が必要です。完全なリファレンス: docs/tools.md。認可ポリシー: docs/authorization.md。

ドキュメント

技術スタック

• ランタイム: Cloudflare Workers (compatibility_date: 2026-08-01, nodejs_compat)

• フレームワーク: Hono v4

• JWT: jose v6 (RS256 via JWKS)

• プロトコル: MCP 2025-06-18, Streamable HTTP

• 認証: 中央集権型認証ワーカー（auth.paxaver.com）による RS256 JWT 検証

• ビルド/デプロイ: Wrangler v4

• テスト: Vitest v2 (Workers pool + Node pool)

ライセンス

Apache-2.0。Copyright (c) 2026 Smartoire。LICENSE を参照してください。