Juhe Weather MCP Server

Name: Juhe Weather MCP Server
Author: juhemcp

@juhemcp

Repository

About Juhe Weather MCP Server

No overview available yet

#jweather #weather-server #weather-api

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

根据城市、地区、区县名称查询当地实时天气预报情况.

Overview

What is Juhe Weather MCP Server?

Juhe Weather MCP Server is a Model Context Protocol (MCP) server that provides nationwide weather forecast query functionality. It enables large language models (LLMs) to retrieve real-time weather forecasts for cities, regions, and districts across China using the Juhe (聚合数据) weather API.

How to use Juhe Weather MCP Server?

Install and run the server using uvx jweather-mcp-server (recommended) or install via pip and run with python -m jweather_mcp_server. You must set the environment variable JUHE_WEATHER_API_KEY with your API key from the Juhe weather service. The server exposes a single tool query_weather which requires a city string parameter (e.g., "北京", "上海") to query weather for that location.

Key features of Juhe Weather MCP Server

One MCP tool: query_weather for real-time weather data.
Supports query by city, district, or region name.
Integrates with the Juhe weather forecast API.
Runs via uvx (no separate install) or pip.
Designed for Chinese city/region names.
Requires a valid Juhe API key for authentication.

Use cases of Juhe Weather MCP Server

An AI assistant answering “What’s the weather in Shanghai today?”
A chatbot providing real-time weather for a user’s specified city.
An automation workflow that checks weather conditions before scheduling events.

FAQ from Juhe Weather MCP Server

How do I get a Juhe Weather API key?

Obtain an API key from the Juhe weather forecast API page at https://www.juhe.cn/docs/api/id/73.

What are the runtime requirements?

The server requires Python 3.10 or higher and can be installed via uv (recommended) or pip.

What transport and authentication does the server use?

The server uses the standard MCP transport layer. Authentication is handled via the JUHE_WEATHER_API_KEY environment variable passed to the server.

Does the server support cities outside China?

No. The server is designed for Chinese cities, regions, and districts. The city name must be a standard Chinese location name to avoid query failure.

What data does the server return?

It returns real-time weather forecast data for the queried location, as provided by the Juhe API. The tool returns a list of TextContent, ImageContent, or EmbeddedResource objects.