MCPサーバーテンプレート

権限境界、統合テスト、評価コントラクトを備えた本番グレードのMCPサーバー用スターターテンプレート。

テンプレート

テンプレート	説明	主な機能
basic	最小限のMCPサーバー	Echo + 計算ツール、Zodバリデーション
database	読み取り専用データベースアクセス	SQLバリデーション、スキーマイントロスペクション、権限境界
api-gateway	外部APIプロキシ	レート制限、認証情報のスコープ設定、エンドポイント設定

クイックスタート

このリポジトリをクローンするか、GitHubの「Use this template」を使用してください
使用したいテンプレートに移動します: cd templates/basic
依存関係をインストールします: pnpm install
サーバーを起動します: pnpm start

アーキテクチャ

各テンプレートは同じパターンに従います:

権限エンジン — すべてのツール呼び出しの前に評価される宣言型ルール（許可/拒否）
インメモリテストクライアント — MCP SDKのInMemoryTransportを使用した統合テスト
評価コントラクト — @visystems/claude-eval-runner と互換性のあるYAML評価仕様

共有ユーティリティ

shared/ ディレクトリには再利用可能なユーティリティが含まれています:

permissions/ — 権限ポリシーの型、エンジン、および PermissionDeniedError
testing/ — 統合テスト用のインメモリMCPテストクライアント
errors/ — 型定義されたエラークラス

開発

pnpm install
pnpm typecheck    # TypeScript type checking
pnpm test         # Run all tests
pnpm test:shared  # Run shared utility tests only
pnpm test:basic   # Run basic template tests only