What is MCP?

基本能力

产品定位

MCP-Server-Starter 是一个用于快速构建 MCP 服务器的 TypeScript 模板，旨在简化 AI 代理与工具交互的开发过程。

核心功能

• MCP 服务器：作为桥梁，将 API、数据库和代码库暴露给外部 AI 主机
• MCP 客户端：使用 TypeScript SDK 进行类型安全的交互
• MCP 主机：协调服务器和客户端之间的请求，确保数据流畅
• 工具响应格式：标准化的工具响应格式，支持多种内容类型
• 安全实践：包括输入验证、错误处理和资源管理
• 高级功能：支持流式响应、自定义内容类型和异步工具执行

适用场景

• AI 代理与工具集成
• 开发 AI 辅助工具
• 构建标准化 API 接口
• 创建可复用的计算逻辑

工具列表

• 计算器工具：示例计算器工具实现
• REST API 工具：示例 REST API 工具实现

常见问题解答

• 如何验证输入参数？使用 Zod 模式进行严格验证
• 如何处理错误？实现适当的错误边界并返回用户友好的错误消息
• 如何管理资源？实现适当的清理程序和处理终止信号

使用教程

使用依赖

• Node.js (v18 或更高版本)
• npm (v7 或更高版本)
• VS Code 与 Dev Containers 扩展

安装教程

1. 克隆模板仓库
2. 在 VS Code 中使用 Dev Containers 打开项目
3. 安装依赖：

npm install

1. 构建项目：

npm run build

调试方式

• 使用检查器模式：

npm run inspector

• 监视模式：

npm run watch

• 单元测试：使用 Jest 测试工具

高级功能

流式响应

支持长时间运行操作的流式响应

自定义内容类型

可以定义专门数据的自定义内容类型

异步工具执行

实现适当的异步处理

测试与调试

单元测试

使用 Jest 测试工具

调试工具

1. MCP 检查器：提供实时检查
2. 日志记录：实现适当的日志记录
3. 错误跟踪：处理未捕获的异常

传输配置

支持多种传输协议： - stdio 传输 - WebSocket 传输 - 自定义传输

服务器能力

配置服务器能力，包括工具支持、流式支持和自定义内容类型

与 MCP 主机集成

支持多种 AI 平台： - Claude Desktop - Cursor - Windsurf - Cline - TypeScript

开发最佳实践

1. 使用 TypeScript
2. 采用一致的模式实现工具
3. 包含全面的文档
4. 利用检查器进行调试
5. 部署前进行全面测试
6. 遵循 MCP 最佳实践

许可证

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