Weather MCP

🚀 即時天氣服務 - Said MCP

Said MCP 是一個簡單而強大的 MCP（模型上下文協議）服務器實現，旨在通過一個易於使用且可擴展的工具，提供即時天氣信息。

✨ 主要特性

• 🔧 使用 @modelcontextprotocol/sdk 構建的自定義 MCP 服務器
• 📍 通過 Open-Meteo API 實現的精確地理定位
• 🌡️ 提供即時氣象數據，包括溫度、降雨和降水量
• ⚡ 基於 stdio 傳輸的簡潔高效接口

🧠 工作原理

服務器提供了一個名為 obtener-clima 的工具，可用於查詢任何城市的天氣狀況。該工具會將城市名稱解析為地理座標，並查詢最新的氣象數據。

🔍 執行流程

1. 🏙️ 接收城市名稱。
2. 🌍 通過 Open-Meteo 的地理編碼 API 獲取該城市的緯度和經度。
3. ☁️ 查詢當前的氣象數據。
4. 📝 以結構化格式返回信息。

📦 項目結構

.
├── .gitignore
├── main.ts              # MCP 服務器的主文件
├── package.json         # 項目依賴和元數據
├── package-lock.json    # 依賴版本控制
└── README.md            # 本文件 📝

🛠️ 安裝指南

環境要求

• NodeJS >= 18
• TypeScript
• 可訪問互聯網（用於調用 API）

💻 使用示例

基礎用法

server.tool(
  'obtener-clima',
  'Herramienta para obtener el clima en tiempo real',
  { city: z.string().describe('City name') },
  async ({ city }) => {
    // Consulta a la API y retorno de datos...
  }
)

高級用法

const transport = new StdioServerTransport()
await server.connect(transport)

上述代碼展示了服務器如何使用 StdioServerTransport 進行連接，便於與支持 MCP 的系統進行集成。

📚 詳細文檔

服務器使用 StdioServerTransport 進行連接，可輕鬆與支持 MCP 的系統集成。

📄 許可證

本項目採用 MIT 許可證。

✨ 作者

本項目由 Said Ruiz 熱情開發。