Jweather MCP Server

🚀 聚合數據天氣 MCP 服務器

聚合數據天氣 MCP 服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，它提供全國天氣預報查詢功能，能讓大型語言模型（LLMs）獲取全國城市、地區的天氣預報情況。

🚀 快速開始

此服務器可讓大型語言模型輕鬆獲取全國城市、地區的天氣預報信息。你只需完成安裝和配置，即可使用其提供的查詢工具。

✨ 主要特性

• 便捷查詢：提供 query_weather 工具，可根據城市、地區、區縣名稱查詢當地即時天氣預報情況。
• 多方式安裝：支持使用 uv（推薦）或 pip 安裝依賴項。
• 靈活配置：可通過環境變量或命令行進行配置。

📦 安裝指南

此服務器需要 Python 3.10 或更高版本。你可以使用 uv（推薦）或 pip 安裝依賴項。

使用 uv（推薦）

當使用 uv 時不需要任何特定安裝。我們將直接使用 uvx 運行 jweather-mcp-server。

uvx jweather-mcp-server

使用 PIP

或者，你可以通過 pip 安裝 jweather-mcp-server：

pip install jweather-mcp-server

安裝完成後，可以作為腳本運行：

python -m jweather_mcp_server

📚 詳細文檔

組件 - 工具

服務器實現了一個工具：

• query_weather：根據城市、地區、區縣名稱查詢當地即時天氣預報情況。
  • 需要傳入 "city"（城市、區縣等名稱）作為必須的字符串參數。

async def query_weather(
    city: str = Field(description="查詢的城市名稱，如北京、上海、廣州、深圳、泰順等；城市或區縣或地區名使用簡寫，嚴格按照規範填寫，否則會導致查詢失敗")
) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

配置

環境變量

JUHE_WEATHER_API_KEY：聚合數據的天氣預報查詢 API 密鑰。獲取：https://www.juhe.cn/docs/api/id/73

JUHE_WEATHER_API_KEY=your_api_key

命令行配置

調試

你可以使用 MCP 檢查器來調試服務器。 對於 uvx 安裝：

npx @modelcontextprotocol/inspector uvx jweather-mcp-server 

或者如果你在特定目錄安裝或開發中：

cd path/to/servers/src/jweather-mcp-server
npx @modelcontextprotocol/inspector uv run jweather-mcp-server

命令行示例問題

1. "查詢下蘇州的天氣"
2. "今天上海的天氣如何？"