金大哥 - juhemcp_jweather-mcp-server MCP 详情

article

README

🚀 聚合数据天气 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="苏州")

命令行示例问题

以下是一些命令行示例问题：

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

🔧 技术细节

组件 - 工具

服务器实现了一个工具 query_weather，其功能和参数说明如下：

功能：根据城市、地区、区县名称查询当地实时天气预报情况。
参数：
- city：查询的城市名称，如北京、上海、广州、深圳、泰顺等；城市或区县或地区名使用简写，严格按照规范填写，否则会导致查询失败。该参数为必须的字符串参数。

配置

环境变量

JUHE_WEATHER_API_KEY 是聚合数据的天气预报查询 API 密钥，可从 https://www.juhe.cn/docs/api/id/73 获取。配置方式如下：

JUHE_WEATHER_API_KEY=your_api_key

命令行配置

使用 uvx

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

使用 pip 安装

"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

juhemcp_jweather-mcp-server