Weather Mcp China

Name: Weather Mcp China
Author: LLM Mart

No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.

Current weather + up to 7-day forecasts for cities worldwide (Chinese and English city names, Chinese output), with dual data sources for reliability.

Try it in 30 seconds: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).
Or self-host: a single Python file, stdlib HTTP + FastMCP, zero paid dependencies.

⚡ Use the hosted endpoint (no setup)

https://mcp.pianam.cn/weather-mcp/mcp

Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.

🔌 Client configuration

Add this to your MCP client's mcpServers configuration (Claude Desktop claude_desktop_config.json, Cursor mcp.json, Cline, Cherry Studio, etc.):

{
  "mcpServers": {
    "weather": {
      "type": "http",
      "url": "https://mcp.pianam.cn/weather-mcp/mcp"
    }
  }
}

Clients that do not accept "type": "http" (some Cherry Studio / older Cline versions) accept the same entry with just "url".

🧰 Tools

Tool	Parameters	Returns
`query_weather(city, days=3)`	`city`: Chinese or English city name, e.g. `"青岛"`, `"北京"`, `"Tokyo"`. `days`: forecast days, 1–7 (default 3).	Current conditions (weather text, temperature, feels-like, humidity, wind direction/speed) + daily forecast (date, weather, high/low, precipitation probability).

📡 Data sources, caching & limits

Primary source: Open-Meteo — free, no API key, no registration; geocoding + forecast, with Chinese-language city resolution (administrative-city ranking to avoid village name collisions).
Automatic fallback: wttr.in if the primary source fails.
WMO weather codes and wind directions are translated to Chinese in the output.
Results cached for 600 seconds; the hosted endpoint is rate-limited to 200 requests / minute / IP.

🐢 Self-hosting

git clone https://github.com/boy-373/weather-mcp-china.git
cd weather-mcp-china
pip install -r requirements.txt
python weather_mcp_server.py
# the server listens on 127.0.0.1:8004 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python weather_mcp_server.py
#   MCP_ALLOWED_HOSTS="your-domain.com,127.0.0.1:*"
#   MCP_ALLOWED_ORIGINS="https://your-domain.com"

Then point your MCP client at http://127.0.0.1:8004/mcp. No API keys or accounts are ever required.

🐳 Self-host with Docker

Option A — pull the pre-built image (fastest, no build):

docker run -d -p 8000:8000 --name weather-mcp-china ghcr.io/boy-373/weather-mcp-china:latest

Option B — build from source:

git clone https://github.com/boy-373/weather-mcp-china.git
cd weather-mcp-china
docker build -t weather-mcp-china .
docker run -d -p 8000:8000 --name weather-mcp-china weather-mcp-china

Then point your MCP client at http://127.0.0.1:8000/mcp. The container listens on 0.0.0.0:8000 by default (override with -e MCP_PORT=9000 and adjust -p accordingly). No API keys or accounts required.

🗂️ Files

weather_mcp_server.py — the MCP server (FastMCP, Streamable HTTP transport).
rate_limit.py — lightweight per-IP sliding-window rate-limit middleware (200 req/min default).
requirements.txt — mcp, uvicorn, starlette.
server.json — official MCP Registry manifest (remote server entry, ready to publish with mcp-publisher).
smithery.yaml / glama.json — directory listing metadata.

🇨🇳 中文使用说明

一句话：全球城市实时天气与多日预报，中文城市名直接查、结果中文输出，最长 7 天预报。

在线直连地址（免费、无需 Key、开箱即用）：https://mcp.pianam.cn/weather-mcp/mcp

在 MCP 客户端（Claude Desktop / Cursor / Cherry Studio / Cline 等）的配置里加入：

{
  "mcpServers": {
    "weather": {
      "type": "http",
      "url": "https://mcp.pianam.cn/weather-mcp/mcp"
    }
  }
}

工具：