MCP工具开发脚手架

MCP工具开发脚手架是一个基于Bun运行时和Express框架构建的项目,旨在帮助开发者快速开发符合Model Context Protocol (MCP)的工具。MCP是一种允许AI模型调用外部工具和服务的协议,通过MCP,AI可以执行各种操作如发送邮件、推送通知、查询数据库等。该脚手架提供了基础架构和示例工具,支持流式响应、API密钥身份验证、工具注册和管理等功能。

  • by frankie0736
  • 更新于
在 GitHub 查看 frankie0736/ts-xiaoman-mcp

使用说明

基本能力

产品定位

MCP工具开发脚手架旨在为开发者提供一个快速开发MCP工具的基础框架,简化MCP工具的开发流程。

核心功能

  • 完整的MCP服务器实现,支持流式响应
  • 基于API密钥的身份验证机制
  • 工具注册和管理系统
  • 包含3个示例工具(回显、邮件发送、微信通知)供参考

适用场景

  • 开发AI模型调用的外部工具
  • 快速构建符合MCP协议的服务
  • 学习MCP工具开发的最佳实践

使用教程

使用依赖

  • 需要安装Bun 1.0.0或更高版本

安装教程

# 克隆脚手架仓库
git clone <repository-url>
cd <repository-directory>

# 安装依赖
bun install

运行

# 开发模式,支持热重载
bun dev

# 生产模式
bun start

调试方式

使用cURL或Postman向/mcp端点发送请求来测试工具:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "mcp-send-key: sk_your_key" \
  -H "mcp-sc-key: SC_your_key" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tool",
    "params": {
      "tool": "my-tool",
      "arguments": {
        "param1": "测试值",
        "param2": 123
      }
    },
    "id": "test-1"
  }'