Juhemcp Jweather MCP Server

🚀 聚合數據天氣 MCP 服務器

一個提供全國天氣預報查詢功能的模型上下文協議（Model Context Protocol）服務器。該服務器可讓大型語言模型（LLMs）獲取全國城市、地區的天氣預報情況。

🚀 快速開始

聚合數據天氣 MCP 服務器為大型語言模型提供了全國天氣預報查詢功能，通過該服務器，LLMs 能輕鬆獲取各地的天氣信息。

✨ 主要特性

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

📦 安裝指南

此服務器需要 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，用於根據城市、地區、區縣名稱查詢當地即時天氣預報情況。

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

使用時，需要傳入 "city"（城市、區縣等名稱）作為必須的字符串參數。例如：

# 示例代碼，假設已經導入相關模塊
# result = await query_weather(city="蘇州")

命令行示例問題

以下是一些命令行示例問題：

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

🔧 技術細節

組件 - 工具

服務器實現了一個工具 query_weather，其功能和參數說明如下：

• 功能：根據城市、地區、區縣名稱查詢當地即時天氣預報情況。
• 參數：
  • city：查詢的城市名稱，如北京、上海、廣州、深圳、泰順等；城市或區縣或地區名使用簡寫，嚴格按照規範填寫，否則會導致查詢失敗。該參數為必須的字符串參數。

配置

環境變量

JUHE_WEATHER_API_KEY 是聚合數據的天氣預報查詢 API 密鑰，可從 https://www.juhe.cn/docs/api/id/73 獲取。配置方式如下：

JUHE_WEATHER_API_KEY=your_api_key

命令行配置

"mcpServers": {
  "jweather-mcp-server": {
    "command": "uvx",
    "args": [
      "jweather-mcp-server"
    ],
    "env": {
      "JUHE_WEATHER_API_KEY": "your_api_key"
    }
  }
}

"mcpServers": {
  "jweather-mcp-server": {
    "command": "python",
    "args": [
      "-m",
      "jmobile_location_mcp_server"
    ],
    "env": {
      "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