mcpField
J
Juhe Weather MCP Server

Juhe Weather MCP Server

本地服务
github.com/juhemcp媒体与设计084 周前更新

关于 Juhe Weather MCP Server

Juhe Weather MCP Server 通过聚合天气 API 提供中国城市和地区的天气预报查询,适用于需要按地名获取本地天气的 MCP 客户端。

主要功能

  1. 01按地名查询当地天气
  2. 02支持城市及区县名称
  3. 03返回天气预报内容

适用场景

  1. 01查询某个城市的天气
  2. 02获取某个区县的天气
  3. 03回答指定地点的天气问题

MCP 相关

它向 MCP 客户端提供 query_weather 工具,接收城市或区县名称并返回天气预报内容。服务需要配置 JUHE_WEATHER_API_KEY。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"jweather": {
"command": "uvx",
"args": [
"jweather-mcp-server"
]
}
}
}
启动命令uvx jweather-mcp-server

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypijweather-mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Juhe Weather MCP Server

一个提供全国天气预报查询功能的模型上下文协议(Model Context Protocol)服务器。该服务器使大语言模型(LLMs)能够获取全国城市、地区的天气预报情况。

组件

工具

服务器实现了一个工具:

  • query_weather:根据城市、地区、区县名称查询当地实时天气预报情况。
    • 需要传入 "city"(城市、区县等名称)作为必需的字符串参数。
async def query_weather(
    city: str = Field(description="查询的城市名称,如北京、上海、广州、深圳、泰顺等;城市或区县或地区名使用简写,严格按照规范填写,否则会导致查询失败")
) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

安装

此服务器需要 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
配置
环境变量

JUHE_WEATHER_API_KEY:聚合数据的天气预报查询 API 密钥。获取:https://www.juhe.cn/docs/api/id/73

JUHE_WEATHER_API_KEY=your_api_key
为 CLINE 配置
使用 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 inspector 调试服务器。对于 uvx 安装:

npx @modelcontextprotocol/inspector uvx jweather-mcp-server 

或者,如果你已将软件包安装到特定目录,或正在开发该软件包:

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

Cline 问题示例

  1. "查询下苏州的天气"
  2. "今天上海的天气如何?"

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。