Workflows MCP 服务器

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

特性

• 此服务器将工作流公开为可供代理使用的工具。 在本例中，天气工作流被公开为一组工具：
  • 公开一个 get-weather 工具，用于获取任何城市的天气数据
  • 提供一个 check-weather 提示模板，以便与 LLM 轻松集成
  • 使用 HTTP/SSE 传输与客户端通信

工作流架构

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

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

这种架构既可以准确检索天气数据，又可以进行智能处理，以更具对话性和易于理解的格式提供天气信息。

关于当前实现的说明

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

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

2. 简化的直接 API - 根目录中的一个纯 JavaScript 实现（direct-server.js 和 direct-client.js），它提供了一个简单的 RESTful 端点，而无需使用 MCP 协议。

为了立即实现功能，我们建议使用简化的直接 API 方法。

前提条件

• Node.js 18 或更高版本
• npm 或 yarn

安装

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

   npm install
   

用法 - 简化的 API 方法

1. 启动服务器：

   node direct-server.js
   

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

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

3. 运行客户端示例：

   node direct-client.js
   

用法 - MCP 方法

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

1. 构建项目：

   npm run build
   

2. 启动服务器：

   npm start
   

3. 服务器将在端口 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 响应中返回给客户端
• 客户端必须在所有后续对 /messages 端点的请求中包含此 ID 作为查询参数
• 这允许服务器将响应路由回正确客户端的 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)：要检查天气的城市名称。

许可证

MIT