Weather Forecast MCP

Weather Forecast MCP

世界中の都市の現在の天気と最大7日間の予報を取得できます（中国語・英語の都市名に対応し、結果は中国語で出力）。信頼性を高めるため、2つのデータソースを使用しています。

• 30秒でお試し：無料の公開 MCP エンドポイントがすでに稼働しています。URL を MCP クライアントに貼り付けるだけです（インストール不要、API キー不要）。
• セルフホストする場合：Python ファイル1つで動作し、標準ライブラリの HTTP と FastMCP を使用します。有料の依存関係はありません。

⚡ ホスト済みエンドポイントを使用する（セットアップ不要）

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

トランスポート：Streamable HTTP（MCP 2025-03-26 互換）。認証は不要です。

🔌 クライアントの設定

MCP クライアントの mcpServers 設定（Claude Desktop の claude_desktop_config.json、Cursor の mcp.json、Cline、Cherry Studio など）に次の内容を追加します。

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

"type": "http" を受け付けないクライアント（Cherry Studio の一部のバージョン／旧バージョンの Cline）では、"url" だけを指定した同じエントリーを使用できます。

🧰 ツール

ツール	パラメーター	戻り値
query_weather(city, days=3)	city：中国語または英語の都市名。例："青岛"、"北京"、"Tokyo"。 days：予報の日数。1～7（デフォルトは3）。	現在の気象状況（天気の説明、気温、体感温度、湿度、風向・風速）と日別予報（日付、天気、最高／最低気温、降水確率）。

📡 データソース、キャッシュ、制限

• プライマリソース：Open-Meteo — 無料で、API キーも登録も不要です。地名解決と天気予報に対応し、中国語の都市名も解決できます（村名との重複を避けるため、行政上の都市を優先して順位付けします）。
• 自動フォールバック：プライマリソースに障害が発生した場合は wttr.in を使用します。
• WMO の気象コードと風向は、出力時に中国語へ翻訳されます。
• 結果は 600秒 間キャッシュされます。ホスト済みエンドポイントには、IP あたり毎分200リクエストのレート制限があります。

🐢 セルフホスト

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"

次に、MCP クライアントを http://127.0.0.1:8004/mcp に接続します。 API キーやアカウントは一切不要です。

🐳 Docker でセルフホスト

オプション A — ビルド済みイメージを取得する（最速、ビルド不要）：

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

オプション B — ソースからビルドする：

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

次に、MCP クライアントを http://127.0.0.1:8000/mcp に接続します。 コンテナはデフォルトで 0.0.0.0:8000 をリッスンします（-e MCP_PORT=9000 で変更し、それに合わせて -p も調整できます）。API キーやアカウントは不要です。

🗂️ ファイル

• weather_mcp_server.py — MCP サーバー（FastMCP、Streamable HTTP トランスポート）。
• rate_limit.py — IP ごとの軽量なスライディングウィンドウ方式レート制限ミドルウェア（デフォルトは毎分200リクエスト）。
• requirements.txt — mcp、uvicorn、starlette。
• server.json — MCP Registry の公式マニフェスト（リモートサーバーのエントリー。mcp-publisher で公開できる状態です）。
• smithery.yaml / glama.json — ディレクトリ掲載用のメタデータ。

---

🇨🇳 中国語での使用方法

ひとことで：世界中の都市のリアルタイムの天気と複数日予報を取得できます。中国語の都市名で直接検索でき、結果は中国語で出力されます。最大7日間の予報に対応しています。

オンライン接続先（無料、キー不要ですぐに利用可能）：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（無料、キー不要）です。障害時は wttr.in に自動で切り替わります。

サービスの特長：すべてのデータソースは公開 API で、登録や支払いは不要です。サーバー側でメモリキャッシュを使用し、障害時には自動で縮退または予備の経路へ切り替わります。IP あたり毎分200リクエストのレート制限があります。

ローカルでのデプロイ：

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 覆盖

Docker でのセルフホスト：

# 方式一：直接拉预构建镜像（最快，无需构建）
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-china
docker 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 キーやアカウントは一切不要です。

📄 ライセンス

MIT © 2026 boy-373

Smithery 経由でインストール

Smithery に対応したクライアント（Claude Desktop、Cursor など）にワンクリックでインストールできます。

または、次のコマンドを実行します。

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

---

🔌 あらゆる AI クライアントで利用可能 — ワンクリック MCP ゲートウェイ

無料のMCP 集約ゲートウェイをホストしています。AI アシスタント（Cherry Studio、Claude Desktop、Cursor、Cline など、あらゆる MCP クライアント）が、1 つの URL を通じて MCP ツールを検出し、利用できます。

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

一度追加するだけで、あとは自然な言葉で話しかければ、AI が適切な MCP を自動で検索 → 調査 → 呼び出しします。

• 🔍 インデックス済みの MCP サーバー 22,000 件以上を横断検索（中国語・英語）
• ⚡ 50 以上の稼働中 MCPをすぐに直接呼び出し可能（天気、為替レート、注目トレンド、IP ジオロケーション、列車のチケットなど）
• 📦 GitHub ベースの MCP：検索で見つけ、ローカルにインストールするためのリンクを確認できます
• ✅ サーバーの稼働状況を毎週チェックし、稼働中のサーバーを優先表示します
• 🆓 無料で利用でき、キーは不要です

📖 3 ステップのセットアップガイド / 中国語の接続チュートリアル: https://mcp.pianam.cn/ai-gateway