Weather Forecast MCP

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

📡 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 60 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.

🗂️ Files

• weather_mcp_server.py — the MCP server (FastMCP, Streamable HTTP transport).
• rate_limit.py — lightweight per-IP sliding-window rate-limit middleware (60 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"
    }
  }
}

工具：

• query_weather(city, days)：查天气。城市名中英文均可（「青岛」「北京」「Tokyo」），days 为预报天数（1-7，默认 3）。
• 返回当前天气（天气状况/温度/体感温度/湿度/风向风速）+ 每日预报（日期/天气/最高最低温/降水概率）。
• 主数据源 Open-Meteo（免费无需 Key），故障自动切换 wttr.in。

服务特性：数据源全部为公开接口、无需注册/付费；服务端内存缓存、失败自动降级/切换备用通道；单 IP 限流 60 次/分钟。

本地部署：

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
# 默认监听 127.0.0.1:8004，可用环境变量 MCP_HOST / MCP_PORT / MCP_ALLOWED_HOSTS / MCP_ALLOWED_ORIGINS 覆盖

📄 License

MIT © 2026 boy-373

Install via Smithery

One-click install for Smithery-supported clients (Claude Desktop, Cursor, etc.):

Or run:

npx -y @smithery/cli install 1561852680/weather-mcp-china --client claude