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 服務器

此部分文檔尚未完善，我們將盡快提供詳細信息。