Weather Forecast MCP

cn.pianam.mcpPublished by mcp.pianam.cnOfficial publisherv1.0.0Updated Nov 2, 2026

MCP server for current weather and multi-day forecasts worldwide, Chinese city names and output.

The publisher's own server: China 12306 Train Tickets MCP

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Remote MCP server that lets an assistant look up current weather and up to 7-day forecasts for cities worldwide, with Chinese city names and Chinese output.

What you can do
  • Query current weather and forecasts for a city: weather text, temperature, feels-like, humidity, wind direction and speed, plus daily highs/lows and precipitation probability.
  • Accept Chinese or English city names and return results in Chinese, with WMO codes and wind directions translated.
  • Choose a forecast horizon from 1 to 7 days (default 3).
  • Rely on a primary source with an automatic fallback to a second source, with results cached for 600 seconds.
When to use it
Useful when an assistant should answer weather questions for Chinese or international cities, especially in Chinese-language conversations, without any account or API key. Add it if you want a zero-setup hosted endpoint rather than building weather lookups yourself.
Requirements
Either the hosted Streamable HTTP endpoint (no install, no API key) or a self-hosted copy: a Python server with its requirements, or a Docker image, listening on a local port. No accounts or credentials are required. Network access to the public weather data sources is needed.
Before you install
The hosted endpoint is rate-limited per IP (200 requests per minute) and caches results for 600 seconds, so data may lag slightly. City names you query are sent to third-party public weather services. The README also advertises a separate aggregation gateway; adding that is a different choice from adding this weather server.

Installation

In SourceWeft

  1. Open Weather Forecast MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/cn.pianam.mcp%2Fweather-mcp-china/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Weather Forecast MCP

[License: MIT] [MCP] [Remote]

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.):

json
{  "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

ToolParametersReturns
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

bash
git clone https://github.com/boy-373/weather-mcp-china.gitcd weather-mcp-chinapip install -r requirements.txtpython 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):

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

Option B — build from source:

bash
git clone https://github.com/boy-373/weather-mcp-china.gitcd weather-mcp-chinadocker 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 等）的配置里加入：

json
{  "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 限流 200 次/分钟。

本地部署：

bash
git clone https://github.com/boy-373/weather-mcp-china.gitcd weather-mcp-chinapip install -r requirements.txtpython weather_mcp_server.py# 默认监听 127.0.0.1:8004，可用环境变量 MCP_HOST / MCP_PORT / MCP_ALLOWED_HOSTS / MCP_ALLOWED_ORIGINS 覆盖

Docker 自托管：

bash
# 方式一：直接拉预构建镜像（最快，无需构建）docker run -d -p 8000:8000 --name weather-mcp-china ghcr.io/boy-373/weather-mcp-china:latest
# 方式二：从源码构建git clone https://github.com/boy-373/weather-mcp-china.git && cd weather-mcp-chinadocker build -t weather-mcp-china .docker run -d -p 8000:8000 --name weather-mcp-china weather-mcp-china# MCP 地址填：http://127.0.0.1:8000/mcp

容器默认监听 0.0.0.0:8000（可用 -e MCP_PORT=端口 改），无需任何 API Key 或账号。

📄 License

MIT © 2026 boy-373

Install via Smithery

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

[Smithery]

Or run:

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

🔌 Use with Any AI Client — One-Click MCP Gateway

We host a free MCP aggregation gateway: your AI assistant (Cherry Studio, Claude Desktop, Cursor, Cline — any MCP client) discovers and uses MCP tools through a single URL:

https://mcp.pianam.cn/ai/mcp

Add it once, then talk in plain language — the AI automatically searches → inspects → calls the right MCP for you.

  • 🔍 Search across 22,000+ indexed MCP servers (Chinese & English)
  • ⚡ 50+ live hosted MCPs callable directly out of the box (weather, exchange rates, hot trends, IP geo, train tickets…)
  • 📦 GitHub-based MCPs: search finds them with links to install locally
  • ✅ Servers health-checked weekly — alive ones ranked first
  • 🆓 Free to use, no key required

📖 3-step setup guide / 中文接入教程: https://mcp.pianam.cn/ai-gateway

Source: README.md at commit 02d1997

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Pianam integrations

China 12306 Train Tickets MCP

cn.pianam.mcpOfficial publisher

A read-only MCP server that lets an assistant look up China Railway 12306 train schedules and remaining seat availability by Chinese station name and date.

Streamable HTTPWeb executable
Location & LifestyleNot indexed yetOct 24, 2026

Stock Mcp

cn.pianam.mcpOfficial publisher

A remote MCP server that gives an assistant real-time China A-share stock quotes and the three major market indices, with dual-source fallback.

Streamable HTTPWeb executable
FinanceNot indexed yetOct 24, 2026

MCP Aggregation Gateway — 22k+ MCP search & call

cn.pianam.mcpOfficial publisher

A remote MCP gateway that lets an assistant search a catalog of 22k+ MCP servers and call 50+ hosted tools without an API key.

Streamable HTTPWeb executable
Developer ToolsNot indexed yetOct 24, 2026

IP Location MCP

cn.pianam.mcpOfficial publisher

A remote MCP server that looks up IPv4 geolocation — country, region, city, coordinates, timezone, ISP and ASN — with Chinese-language output.

Streamable HTTPWeb executable
Location & LifestyleNot indexed yetOct 24, 2026

China Hot Trending MCP

cn.pianam.mcpOfficial publisher

A remote MCP server that fetches real-time hot-search and trending boards from eight Chinese platforms, such as Weibo, Zhihu and Bilibili, in one call.

Streamable HTTPWeb executable
Web Search & ScrapingNot indexed yetOct 24, 2026