weather-mcp-server

🌦 WeatherTrax MCP サーバー

Claude やその他の MCP クライアント向けの、高速で信頼性の高い気象データです。
世界中のあらゆる場所の現在の天気と複数日間の予報を取得できます。

🌐 リモート MCP サーバー（インストール不要）
https://mcp-weathertrax.jaredco.com/mcp

---

---

⚡ 10 秒で試すデモ

Claude に尋ねます：

「明日のマイアミの天気は？」

Claude が MCP 気象サーバーを呼び出し、すぐに予報を返します。

API 呼び出しの例：

curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \
  -H "Content-Type: application/json" \
  -d '{"location":"Miami","query_type":"current"}'

---

🚀 主な機能

• リアルタイムの気象データ – 現在の天気、気温、湿度、風速
• 複数日間の予報 – 最大 14 日間の予報
• 計画用ツール – イベントや建設作業に最適化された 7 日間予報
• 柔軟な場所の指定 – 都市名、郵便番号、座標
• トークン効率に優れる – LLM での利用に最適化された簡潔な応答
• 本番環境対応 – レート制限と監視機能
• 公開 API – API キーは不要
• MCP 準拠 – JSON-RPC 2.0 を完全サポート

---

⚡ クイックスタート

Claude

Claude または Claude Desktop で、Settings → Connectors → Add connector を開き、次を使用します：

Name: WeatherTrax
URL:  https://mcp-weathertrax.jaredco.com/mcp

これで次のように尋ねられます：

What’s the weather in New York this weekend?

---

🌐 API の直接利用

ヘルスチェック

curl https://mcp-weathertrax.jaredco.com/healthz

MCP マニフェスト

curl https://mcp-weathertrax.jaredco.com/.well-known/mcp/manifest

---

💡 使用例

現在の天気

curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \
  -H "Content-Type: application/json" \
  -d '{
    "location": "San Francisco, CA",
    "query_type": "current"
  }'

応答例：

{
  "summary": "It is currently 54°F and Clear in San Francisco.",
  "temp_high": 54,
  "temp_low": 54,
  "condition": "Clear",
  "wind": "5 mph W",
  "humidity": 65
}

---

複数日間の予報

curl -X POST https://mcp-weathertrax.jaredco.com/tools/weatherTool \
  -H "Content-Type: application/json" \
  -d '{
    "location": "New York",
    "query_type": "multi_day",
    "num_days": 3
  }'

---

🛠 利用可能なツール

weatherTool

現在の天気または予報を取得します。

入力：

{
  "location": "city name or coordinates",
  "query_type": "current | multi_day",
  "num_days": "optional forecast length"
}

---

weatherPlanningTool

屋外作業やイベント向けの 7 日間計画用予報です。

入力：

{
  "location": "city or place",
  "context": "construction | travel | event",
  "timeframe": "optional timeframe hint"
}

---

🔗 MCP プロトコル連携

このサーバーは MCP JSON-RPC プロトコルを完全にサポートしています。

ツール呼び出しの例：

curl -X POST https://mcp-weathertrax.jaredco.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{
      "name":"weatherTool",
      "arguments":{
        "location":"London",
        "query_type":"current"
      }
    }
  }'

---

🧪 テスト

1 つ目のターミナルでローカル実行します：

npm install
npm start

別のターミナルで、プロトコルテストを実行します：

npm test

リリース用スモークテストスイート：

npm run test:full

npm run test:full は現在、同じサポート対象のエンドツーエンド・スモークテストスイートを実行します。旧式の Streamable HTTP 導入前の回帰テストハーネスは、引き続き npm run test:legacy で利用できます。参考用に保持されており、リリースの必須条件ではありません。

デプロイ設定

次の環境変数をサーバー側で設定してください。これらをコミットしないでください：

変数	必須	用途
WEATHER_API_KEY	はい	World Weather Online の API キー。
PORT	いいえ	HTTP リスナーポート。デフォルトは 3000 です。
TRUST_PROXY	本番環境による	信頼するリバースプロキシのホップ数。既知のプロキシを 1 つ使用する場合は 1 に設定します。
ALLOWED_ORIGINS	いいえ	MCP の呼び出しを許可するブラウザーのオリジンをカンマ区切りで指定します。デフォルトは https://claude.ai です。

このサービスは、個人を特定しない集計済みの運用カウンターを /metrics で公開します。適切なアクセス制御を追加せずに、このエンドポイントを公開ダッシュボードの背後に配置しないでください。

---

🔒 プライバシー

プライバシーポリシーはこちら：

https://mcp-weathertrax.jaredco.com/privacy

主な内容：

• 集計済みの運用メトリクスのみを使用。場所やプロバイダーからの生の応答は記録しません
• 短期間のメモリ内キャッシュにより、プロバイダーへの重複リクエストを削減します
• Cookie やトラッキングは使用しません
• HTTPS を強制します

---

🛠 開発

リポジトリをクローンします：

git clone https://github.com/jaredco/weather-mcp-server.git
cd weather-mcp-server
npm install
npm start

サーバーは次のアドレスでローカル実行されます：

http://localhost:3000

---

📦 技術スタック

• Node.js
• Express 5
• @modelcontextprotocol/sdk
• World Weather Online API
• Railway ホスティング

---

📄 ライセンス

MIT ライセンス。

---

🌟 謝辞

Anthropic の Model Context Protocol を使用して構築されています。

気象データは World Weather Online によって提供されています。

---

📊 ステータス

サーバー：本番環境
API バージョン：1.0.1
MCP プロトコル：2025-03-26

---

Claude と MCP のために ☀️ を込めて