JinDaGe - jweather-mcp-server MCP Details

article

README

🚀 聚合数据天气 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

命令行配置

使用 uvx

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

使用 pip 安装

```json "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

命令行示例问题

"查询下苏州的天气"
"今天上海的天气如何？"

jweather-mcp-server