MCP服务器示例项目

这是一个基于Model Context Protocol的服务器示例，实现了简单的计算工具功能。

工作流程

flowchart TD
    A[启动服务器] --> B[工具注册]
    B --> C[等待请求]
    C --> D{请求类型?}
    D -->|list_tools| E[返回工具列表]
    D -->|call_tool| F[执行工具]
    F --> G[返回结果]
    E --> C
    G --> C

功能特性

• 提供计算两数之和的工具
• 支持标准输入输出传输
• 完善的错误处理机制

安装步骤

1. 确保已安装Node.js (版本16+)和npm
2. 克隆项目仓库
3. 安装依赖:

npm install

4. 构建项目:

npm run build

使用方法

1. 启动服务器:

npm run inspector

2. 通过标准输入发送请求
3. 服务器将通过标准输出返回结果

示例请求

列出可用工具:

{
  "method": "list_tools",
  "params": {}
}

调用计算工具:

{
  "method": "call_tool",
  "params": {
    "name": "calculate_sum",
    "arguments": {
      "a": 5,
      "b": 3
    }
  }
}

开发

• 开发模式:

npm run watch

NPM包发布指南

1. 准备发布:

# 确保所有测试通过
npm test

# 确保构建产物是最新的
npm run build

# 检查package.json配置
npm pkg get name version main files

2. 登录NPM账号:

npm login

3. 更新版本号(遵循语义化版本):

# 主版本号(不兼容的API修改)
npm version major

# 次版本号(向下兼容的功能新增)
npm version minor

# 修订号(向下兼容的问题修正)
npm version patch

4. 验证发布包内容:

# 查看将被发布的文件列表
npm pack --dry-run

5. 发布到NPM仓库:

npm publish

6. 验证发布结果:

# 查看已发布的包信息
npm view ${package-name}

注意事项

• 确保package.json中的必要字段(name, version, main, files等)已正确配置
• 发布前请确保:
  • 所有测试通过
  • 构建产物是最新的
  • CHANGELOG.md已更新
• 如需发布公开包，请移除package.json中的private字段
• 发布后请及时更新CHANGELOG.md中的版本信息

许可证

ISC