MCP boilerplate: Model Context Protocol Server

基本能力

产品定位

mcp-boilerplate 是一个 MCP 服务器模板，用于标准化 AI 模型与数据源和工具之间的连接。

核心功能

• 实现 MCP Server-Sent Events (SSE) 传输协议
• 提供构建自定义 MCP 服务器的健壮结构
• 包含带有类型定义的示例工具
• 支持 API 密钥的安全认证
• 不同严重级别的日志记录能力
• 多客户端连接的会话管理
• 对 SIGINT 和 SIGTERM 信号的优雅关闭处理

适用场景

• 需要将 AI 模型连接到不同数据源和工具的场景
• 需要标准化通信协议的 AI 项目
• 需要快速搭建 MCP 服务器的开发场景

工具列表

• calculator: 执行基本算术运算（加、减、乘、除）

常见问题解答

1. SSE 超时问题：
2. 减少 keepaliveInterval 以发送更频繁的保持活动消息
3. 确保启用 usePingEvents 以增加连接稳定性
4. 检查代理服务器是否有超时设置

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm

安装教程

1. 安装依赖：

npm install

1. 创建 .env 文件并添加以下变量：

PORT=4005
API_KEY=your_api_key

1. 构建项目：

npm run build

1. 启动服务器：

npm run start:sse

调试方式

1. 开发模式（带热重载）：

npm run start

1. 使用 PM2 生产模式：

npm run start:pm2

1. 使用 nodemon 开发模式：

npm run dev

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。