Amap Weather MCP Server

🚀 中國城市天氣查詢 MCP 服務

本服務基於高德地圖 API，是標準的 Model Context Protocol (MCP) 服務。它允許用戶通過簡單的請求，獲取中國各城市的即時天氣狀況和未來幾天的天氣預報，為各類應用提供準確的天氣數據支持。

🚀 快速開始

本服務可讓你輕鬆查詢中國城市的天氣信息。首先需完成安裝，之後就能使用其提供的功能查詢天氣啦。

✨ 主要特性

• 數據精準：使用高德地圖天氣 API，獲取精確的中國城市天氣數據。
• 即時查詢：支持查詢即時天氣狀況。
• 未來預報：支持查詢未來 3 - 4 天的天氣預報。
• 智能識別：支持智能城市名稱識別，包括城市、區縣級別的查詢。
• 搜索功能：支持城市名稱搜索功能。
• 易於集成：實現為標準 MCP 服務，易於集成到 AI 應用中。

📦 安裝指南

前提條件

• 高德地圖開發者 API 密鑰（需通過環境變量配置）

安裝步驟

1. 克隆或下載本倉庫。
2. 進入項目目錄。
3. 使用 uv 安裝依賴:

uv venv
source .venv/bin/activate
uv add "mcp[cli]" httpx

💻 使用示例

啟動 MCP 服務

若你需要自行創建客戶端測試該 MCP 服務，請手動啟動。在終端中執行以下命令啟動 MCP 服務:

uv run weather.py

使用集成的 MCP 服務

在 Claude Desktop 中使用

若想在 Claude Desktop 中使用，請添加服務器配置：在文本編輯器中打開 Claude for Desktop App 配置，路徑參考如下 ~/Library/Application Support/Claude/claude_desktop_config.json。若文件不存在，請確保創建該文件。

{
    "mcpServers": {
        "amap-weather-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "weather.py"
            ],
            "env": {
                "AMAP_API_KEY": "YOUR_API_KEY_HERE"
            }
        }
    }
}

在 Cherry Studio 中使用

如下圖所示配置即可：

調用服務

MCP 服務提供了三個主要工具函數用於天氣查詢:

1. get_current_weather：獲取城市當前天氣狀況。
2. get_weather_forecast：獲取未來幾天的天氣預報。
3. search_city：搜索城市名稱。

使用 MCP 客戶端調用示例:

from mcp.client import Client

# 連接到服務
client = Client("amap-weather-mcp-server")

# 查詢即時天氣
current_weather = client.get_current_weather()
print(current_weather)

# 查詢未來天氣預報
forecast = client.get_weather_forecast()
print(forecast)

# 搜索城市
cities = client.search_city("上海")
print(cities)

📚 詳細文檔

注意事項

⚠️ 重要提示

1. 環境變量必須正確配置，否則 API 請求將失敗。
2. 城市名稱識別支持直接輸入城市名稱或區縣名稱（建議帶上行政區劃標識如"市"、"縣"、"區"等）。
3. 高德地圖 API 的使用需遵守其服務條款和限制。

📄 許可證

本項目採用 MIT 許可證。