MCP A0c

🚀 雙源天氣 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的天氣服務器，藉助和風天氣和心知天氣 API 來提供天氣數據。它支持故障轉移功能，還能優先獲取最快響應，為用戶提供高效、穩定的天氣信息服務。

🚀 快速開始

本服務器使用和風天氣和心知天氣 API 提供天氣數據，支持故障轉移和優先獲取最快響應。以下是使用該服務器的基本步驟：

1. 安裝服務器（具體安裝步驟見下方“📦 安裝指南”）。
2. 獲取 API 密鑰（具體獲取方式見下方“API 密鑰獲取”）。
3. 運行服務器（具體運行命令見下方“運行”）。
4. 配置客戶端（如在 Claude Desktop 中配置，具體配置方法見下方“在 Claude Desktop 中配置”）。

✨ 主要特性

• 豐富的天氣查詢功能：
  • 可查看當前天氣（作為資源提供）。
  • 能獲取指定城市的當前天氣（工具）。
  • 可獲取指定城市的天氣預報（工具）。
• 智能的 API 源選擇：同時使用多個 API 源，自動選擇最快響應的結果。
• 全面的天氣數據支持：支持最低/最高溫度、溼度和風速數據。

📦 安裝指南

# 克隆倉庫
git clone <repository-url>
cd weather-mcp-server

# 安裝依賴
npm install

# 配置環境變量
cp .env.example .env
# 編輯 .env 文件，添加你的API密鑰

📚 詳細文檔

API 密鑰獲取

和風天氣 API

1. 訪問 和風天氣開發服務。
2. 註冊賬號並創建應用。
3. 在控制檯獲取 API Key。

心知天氣 API

1. 訪問 心知天氣開發服務。
2. 註冊賬號並創建應用。
3. 在控制檯獲取 API Key。

開發

# 構建項目
npm run build

# 監視模式（自動重新構建）
npm run watch

運行

npm start

MCP 模式說明

本服務器僅支持 Model Context Protocol (MCP) 模式運行，不提供 HTTP 服務器功能。MCP 是一種專為大型語言模型設計的協議，允許模型與外部工具和資源進行交互。

MCP 服務器特點

• 使用標準輸入/輸出（stdio）與客戶端通信。
• 提供資源和工具供大型語言模型使用。
• 支持結構化數據交換和錯誤處理。

可用資源

• weather://{city} - 獲取指定城市的當前天氣。

可用工具

• getCurrentWeather - 獲取指定城市的當前天氣。
• getForecast - 獲取指定城市的天氣預報（支持 1 - 7 天）。

在 Claude Desktop 中配置

編輯 Claude Desktop 配置文件：

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["你的完整路徑/weather-mcp-server/build/index.js"],
      "env": {
        "QWEATHER_API_KEY": "你的和風天氣API密鑰",
        "SENIVERSE_API_KEY": "你的心知天氣API密鑰"
      }
    }
  }
}

調試

查看 MCP 的日誌：

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

使用 MCP Inspector 調試

npx @modelcontextprotocol/inspector node 你的完整路徑/weather-mcp-server/build/index.js

然後在瀏覽器中訪問 http://localhost:5173。

故障轉移機制

此服務器同時使用多個天氣 API 源：

1. 首先並行向和風天氣和心知天氣發送請求。
2. 採用最先返回響應的 API 結果。
3. 如果某個 API 失敗，將自動切換到備用 API。
4. 支持最低/最高溫度、溼度和風速數據。

技術文檔

• 設計文檔
• 開發指南
• 接口規範

🤝 貢獻

歡迎提交問題和拉取請求！請參考 貢獻指南 瞭解如何參與。

📄 許可證

MIT License

效果圖