MCP 服务器模板

生产级的 MCP 服务器入门模板，包含权限边界、集成测试和评估契约。

模板

快速开始

1. 克隆此仓库或在 GitHub 上使用“Use this template”

2. 进入所需的模板目录：cd templates/basic

3. 安装依赖：pnpm install

4. 启动服务器：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

许可证

Apache 2.0 — 参见 LICENSE。