Workflows MCP Server

🚀 工作流 MCP 服务器

这是一个基于 Model Context Protocol (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 - 根目录（direct-server.js 和 direct-client.js）中的简单 JavaScript 实现，提供不使用 MCP 协议的 RESTful 端点。

为快速实现功能，建议使用简化的直接 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 (必填) - 城市名称

返回：

• 天气数据，包括温度、湿度等信息

MCP 服务器

此部分文档尚未完善，我们将尽快提供详细信息。