Workflows MCP Server

MCP服务器工作流

这是一个模型上下文协议（MCP）服务器，通过一个简单的API为城市提供天气信息。

特性

• 此服务器将工作流公开为代理可以使用的工具。在这种情况下，天气工作流作为一组工具公开：

- 暴露a get-weather 获取任何城市天气数据的工具 - 提供 check-weather 提示模板，便于与LLM集成 - 使用HTTP/SSE传输与客户端通信

工作流体系结构

Weather Workflow

时中 get-weather 工具被调用时，它会触发一个工作流，该工作流：

1. 将城市名称作为输入
2. 查询OpenWeatherMap服务以获取该位置的当前天气数据
3. 将原始天气数据传递给LLM进行解释
4. 返回当前天气状况的友好、自然语言描述

这种架构允许准确的天气数据检索和智能处理，以更对话和易于理解的格式提供天气信息。

关于当前实施情况的说明

由于MCP协议实现的一些技术挑战，我们提供了两种方法：

1. 原始MCP服务器 -TypeScript在 src 目录，可能与当前SDK版本存在一些兼容性问题。

1. 简化的直接API -根目录中的普通JavaScript实现(direct-server.js 和 direct-client.js)它提供了一个简单的RESTful端点，而不使用MCP协议。

对于即时功能，我们建议使用简化的直接API方法。

先决条件

• Node.js 18或更高版本
• npm或纱线

安装

1. 克隆此存储库
2. 安装依赖项：

   npm install

用法-简化的API方法

1. 启动服务器：

   node direct-server.js

1. 服务器将在端口3000上启动，并提供：

- 天气API： http://localhost:3000/api/weather?city=New%20York - 健康检查： http://localhost:3000/health

1. 运行客户端示例：

   node direct-client.js

用法-MCP方法

这种方法需要构建TypeScript代码，可能存在一些兼容性问题：

1. 构建项目：

   npm run build

1. 启动服务器：

   npm start

1. 服务器将在端口3000上启动：

- SSE 端点 ： http://localhost:3000/sse - 消息端点： http://localhost:3000/messages?connectionId=YOUR_CONNECTION_ID - 健康检查： http://localhost:3000/health

了解连接ID

连接ID是连接到SSE端点时分配给每个客户端会话的唯一标识符。它是保持双向沟通的关键机制：

• 当客户端连接到 /sse 端点，服务器生成一个唯一的连接ID
• 此ID在初始SSE响应中返回给客户端
• 客户端必须将此ID作为查询参数包含在对的所有后续请求中 /messages 端点
• 这允许服务器将响应路由回正确的客户端的SSE连接

例如，如果您的连接ID为 1742761520489，您可以调用工具：

http://localhost:3000/messages?connectionId=1742761520489

api参考

直接API

GET /api/weather

获取指定城市的天气信息。

参数：

• city （string）：获取天气的城市名称。

退货：

• 带有天气信息的JSON响应。

MCP工具

get-weather

获取指定城市的天气信息。

参数：

• city （string）：获取天气的城市名称。

退货：

• 天气信息以文本形式呈现。

MCP提示

check-weather

要求LLM检查和总结天气信息的提示模板。

参数：

• city （string）：要查看天气的城市名称。

许可证

麻省理工学院