met-mcp

met-mcp

MET Norway（Yr）の天気予報を提供する MCP サーバーです。学習プロジェクトとして作成しました。

次の3つの方法で利用できます。

• npm: met-mcp — stdio 経由でローカル実行
• リモート: https://met-mcp.met-mcp-worker.workers.dev/mcp — Cloudflare Workers 上の Streamable HTTP。claude.ai コネクターとして追加できます
• MCP レジストリ: io.github.trondbjoroy/met-mcp

ツール

• geocode_location(name, count) — 地名の座標を検索します。MET にはジオコーディング API がないため、無料の Open-Meteo ジオコーダーを使用します。
• get_forecast(latitude, longitude, hours) — MET Locationforecast 2.0 による時間ごとの予報です。世界中で利用できますが、北欧で最も精度が高くなります。
• get_nowcast(latitude, longitude) — 今後2時間のレーダーに基づく降水情報です。北欧のみで利用できます。
• get_weather_alerts(latitude?, longitude?) — ノルウェーの公式気象警報（MetAlerts）です。ノルウェー全域の情報を取得するには、座標を省略してください。
• get_sun_events(latitude, longitude, date, utc_offset) — 日の出、日の入り、南中時刻です。世界中で利用できます。
• get_ocean_forecast(latitude, longitude, hours) — ノルウェー沿岸の波高と海水温です。
• find_weather_stations(latitude, longitude, count) — 最寄りの公式気象観測所（Frost）を検索します。
• get_historical_weather(station_id, from, to, elements) — Frost アーカイブから日別の過去の観測データを取得します。観測所によっては100年以上前までさかのぼれます。

2つの Frost ツールを使うには、無料のクライアント ID を https://frost.met.no/auth/requestCredentials.html から取得し、FROST_CLIENT_ID 環境変数（または Worker の Cloudflare シークレット）に設定する必要があります。それ以外のツールに必要な設定はありません。

ツールの定義は src/tools.ts にあり、stdio サーバーと Worker で共有されています。

ビルドとテスト

npm install
npm run build
npm test

テストでは、stdio 経由でサーバーを起動し、実際の API に対して両方のツールを呼び出します。

Claude Code での使用

claude mcp add met-weather -- node C:\Users\trond\met-mcp\dist\index.js

次に Claude に「明日のベルゲンの天気は？」と尋ねます。

MET の利用規約

• 連絡先情報を含む識別可能な User-Agent を送信してください。MET_USER_AGENT 環境変数に、たとえば met-mcp/0.1.0 [email protected] を設定します。
• 座標の小数点以下は最大4桁にしてください。サーバーが丸め処理を行います。
• データライセンス：NLOD / CC BY 4.0。データを表示する際は MET Norway をクレジット表記してください。

リモート版

worker/ には Cloudflare Workers へのデプロイ設定があります。createMcpHandler（MCP SDK v2）を使い、同じ2つのツールを MCP Streamable HTTP 経由で提供します。worker/ から npm run dev で開発し、npm run deploy でデプロイできます。

仕組み

• src/index.ts がサーバー全体です。stdio 経由で MCP を処理し、stdin/stdout 上で JSON-RPC をやり取りします。
• 各ツールでは Zod による入力スキーマを定義します。MCP クライアント（Claude）がスキーマを読み取り、引数を検証します。
• ツールの結果は content ブロックです。このサーバーは JSON をテキストとして返し、LLM に必要な内容だけに絞り込みます。MET の生のレスポンスには約90個のタイムステップがあり、さらに多くのフィールドが含まれています。
• console.log で stdout に書き込まないでください。プロトコルのストリームが破損します。ログは stderr に出力してください。