AI导哈

MCP服务器模板

用于构建基于HTTP的MCP（模型上下文协议）服务器的标准模板，包含OAuth提供者、API客户端基类、输入验证助手等功能。

  • by heathweaver
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 heathweaver/mcp-server-template

使用说明

MCP服务器模板

用于构建基于HTTP的MCP（模型上下文协议）服务器的标准模板。

包含内容

  • Express+Streamable HTTP服务器传输 --基于HTTP的MCP传输与会话管理
  • OAuth提供者 --文件支持的PKCE OAuth，支持预共享令牌
  • API客户端基类 --具有错误处理功能的可扩展HTTP客户端
  • 输入验证助手 --所有工具的类型安全参数验证
  • createTool() 工厂 --将HTTP谓词映射到MCP工具的声明性工具定义
  • Docker+Cloudflare隧道 --多阶段构建的生产部署
  • 测试线束 --使用Node内置测试运行器进行本地/远程集成测试

快速开始

  1. 点击 “使用此模板” 在GitHub上
  2. 替换 {{SERVICE_NAME}}, {{SERVICE_DISPLAY_NAME}}, {{SERVICE_UPPER}} 占位符
  3. npm install
  4. 在中实施您的工具 src/index.ts → buildToolConfigs()
  5. npm run build && npm start

看 docs/SETUP-GUIDE.md 详细说明。

文档

  • 安装指南 --逐步设置新服务器
  • 分析 --对所有现有服务器的审计和一致性发现

建筑

Client → HTTP POST /mcp → Bearer Auth → StreamableHTTPServerTransport → MCP Server
                                                                           ↓
                                                                    Tool Handler
                                                                           ↓
                                                                    ApiClient → External API

发展

npm run build          # Compile TypeScript
npm run build:check    # Type check only (no emit)
npm test               # Build + run tests
npm run test:watch     # Watch mode

部署

npm run docker:build   # Full build with tests + Docker image
npm run docker:build:fast  # Skip tests
docker compose up -d   # Start container

相关 MCP