Juhemcp Jweather MCP Server

🚀 Aggregate Data Weather MCP Server

A Model Context Protocol (MCP) server that provides nationwide weather forecast query functionality. This server enables Large Language Models (LLMs) to obtain weather forecast information for cities and regions across the country.

🚀 Quick Start

The Aggregate Data Weather MCP Server is designed to offer nationwide weather forecast query services, allowing Large Language Models (LLMs) to access weather information for cities and regions across the country.

✨ Features

Tools

The server implements one tool:

• query_weather: Query the local real-time weather forecast based on the name of the city, district, or county.
  • It requires a mandatory string parameter "city" (the name of the city, district, etc.).

async def query_weather(
    city: str = Field(description="查询的城市名称，如北京、上海、广州、深圳、泰顺等；城市或区县或地区名使用简写，严格按照规范填写，否则会导致查询失败")
) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

📦 Installation

This server requires Python 3.10 or higher. Install the dependencies using uv (recommended) or pip.

Using uv (Recommended)

When using uv, no specific installation is required. We will use uvx to directly run jweather-mcp-server.

uvx jweather-mcp-server

Using PIP

Alternatively, you can install jweather-mcp-server via pip:

pip install jweather-mcp-server

After installation, you can run it as a script:

python -m jweather_mcp_server

📚 Documentation

Configuration

Environment Variables

JUHE_WEATHER_API_KEY: The API key for the weather forecast query of Aggregate Data. Obtain it from: https://www.juhe.cn/docs/api/id/73

JUHE_WEATHER_API_KEY=your_api_key

Command-line Configuration

"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"
    }
  }
}

Debugging

You can use the MCP inspector to debug the server. For uvx installation:

npx @modelcontextprotocol/inspector uvx jweather-mcp-server 

Or if you have installed the package in a specific directory or are in development:

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

Command-line Example Questions

1. "Query the weather in Suzhou."
2. "How's the weather in Shanghai today?"