MCP微服务示例
一个开发人员友好的演示,展示了如何用MCP服务器包装Node.js微服务,并使用MCP客户端与之交互。
______________________________________________________________________
项目结构
- 微服务 (
src/microservice/):用户、产品和订单的REST API。 - MCP服务器 (
src/mcp-server/):将选定的微服务端点包装为MCP工具。 - MCP客户端 (
src/mcp-client/):交互式CLI,用于调用MCP工具并查看结果。
______________________________________________________________________
运作原理
- 微服务公开HTTP端点。
- MCP服务器将这些端点包装为AI/代理客户端的工具(API)。
- MCP客户端连接到MCP服务器,列出工具,并允许您以交互方式调用它们。
______________________________________________________________________
快速开始
- 安装依赖项:
npm install- 配置环境:
cp .env.example .env
# Edit .env if needed- 启动微服务:
npm run microservice- 启动MCP客户端(生成MCP服务器):
npm run client- 选择服务器、工具,并按照提示提供参数。 - 尝试使用多个工具或服务器,或在完成后退出。
______________________________________________________________________
开发人员提示
- 通过更新添加新的API:
- src/microservice/routes.js (REST端点) - src/mcp-server/tools.js (工具定义) - src/mcp-server/handlers.js (工具操作员)
- 在中添加更多MCP服务器
mcp-servers.config.js. - 客户端支持重复的工具调用和服务器切换。
- 所有错误都以一致的格式返回。
______________________________________________________________________
