GenPDM MCP Server

固定されたビジネスGraphQL APIを安全で型付きのMCPツールとして公開するためのTypeScript/Express MCPサーバースケルトンです。

特徴

• ALL /mcp でのMCP SDK v2 Streamable HTTPエンドポイント

• HS256 Bearer JWT検証とスコープチェック

• IPごとおよびサブジェクトごとのインメモリレート制限

• 境界付きUndici keep-aliveプールを利用したGraphQLクライアント

• クエリのみのリトライ、ミューテーションの冪等性、並行性とレスポンスサイズの制限

• 再現可能なモックGraphQLアップストリーム

• Liveness/readinessエンドポイントとグレースフルシャットダウン

現在のレート制限ストアは意図的にプロセスローカルです。src/rate-limit.ts には、将来のRedisバックアップストアのためのアダプター境界が含まれています。複数のレプリカを実行する場合、現在のカウンターをグローバルとして扱わないでください。

Related MCP server: gqai

ドキュメント

• システムアーキテクチャ

• 実装ガイド

• 開発ガイド

• テストガイド

• ローカル実行と手動テスト

• AIエージェント統合

• エージェントユーザー受け入れテスト

リポジトリ自動化:

• AGENTS.md は常時有効なアーキテクチャと命名規則を定義します。

• genpdm-mcp-development は、CodexによるGraphQLオペレーションとMCPツールの変更をガイドします。

実行可能な例:

• 分離されたGenPDMサンプルエージェント

ローカル実行

Node.js 20以上が必要です。

Copy-Item .env.example .env
npm install
npm run dev:mock

2番目のターミナルで:

npm run dev
$token = npm.cmd run --silent token

エンドポイント http://127.0.0.1:3000/mcp とヘッダー Authorization: Bearer <token> を使用してMCPクライアントを設定します。

利用可能なツール:

• get_customer: { "id": "cust-001" }、customers:read が必要

• create_order: { "customerId": "cust-001", "items": [{ "sku": "SKU-1", "quantity": 2 }] }、orders:write が必要

ヘルスエンドポイントは認証不要です:

• GET /health/live

• GET /health/ready

確認

npm run typecheck
npm run build
npm test

本番運用に関する注意事項

• HS256検証を、会社のIdPのJWKS検証器に置き換えてください。

• 水平スケーリングで厳密なグローバル制限が必要になる前に、インメモリのレート制限ストアをRedisに置き換えてください。

• JWTとGraphQLの資格情報をシークレットマネージャーから注入してください。

• デプロイメントトポロジに合わせて、ALLOWED_HOSTS、CORS_ORIGINS、および信頼済みプロキシ設定を制限してください。