mcp-meteoblue

JavaScript で書かれた meteoblue Weather API 用の MCP サーバーです。MCP クライアントから、場所の検索、Free Weather API で利用可能なパッケージを使った予報の取得、予報メテオグラム画像の要求を行うことができます。

ツール

• search_locations は、meteoblue Location Search を使用して都市、郵便番号、IATA/ICAO 空港コードを解決します。

• get_forecast は、地名または座標を受け取り、予報 JSON を返します。デフォルトでは現在、1 時間ごと、1 日ごとの天気を取得します。

• get_forecast_image は、地名または座標を受け取り、予報画像を MCP クライアントへ直接返します。

予報ツールや画像ツールに渡す地名は、常に公式の meteoblue Location Search API を通じて解決されます。予報パッケージの入力は、Free Weather API ドキュメントに記載されているパッケージに限定されます。

[!NOTE] 現在の meteoblue Free Weather API ドキュメントによると、画像には上位のアクセスレベルが必要です。画像ツールは Image API の権限を保有するキー向けに含まれており、それ以外の場合は明確な認可エラーを返します。

Related MCP server: mcp-weather-server

要件

• Node.js 20 以降

• meteoblue API キー

キーは非公開にしてください。このサーバーは METEOBLUE_API_KEY からキーを読み取ります。キーがパッケージや MCP ツールの引数に含まれることはありません。

npm から実行する

この stdio サーバーを MCP クライアント設定に追加します。

{
  "mcpServers": {
    "meteoblue": {
      "command": "npx",
      "args": ["-y", "mcp-meteoblue"],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

または、直接実行します。

METEOBLUE_API_KEY=your_api_key_here npx -y mcp-meteoblue

このサーバーは stdio を使用するため、MCP クライアントを待機している間は意図的に通常のターミナル出力を行いません。

Docker

イメージをローカルでビルドします。

docker build -t mcp-meteoblue .

MCP クライアントに Docker ベースの stdio サーバーを設定します。

{
  "mcpServers": {
    "meteoblue": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "METEOBLUE_API_KEY",
        "mcp-meteoblue"
      ],
      "env": {
        "METEOBLUE_API_KEY": "your_api_key_here"
      }
    }
  }
}

コンテナは権限のない node ユーザーとして実行されます。MCP 通信は stdio を使用するため、-i で標準入力を開いたままにしてください。

ローカル開発

npm install
npm test
METEOBLUE_API_KEY=your_api_key_here npm start

MCP クライアントを node /absolute/path/to/mcp-meteoblue/src/index.js に向け、そのクライアントの設定で環境変数を設定してください。

リリース

GitHub Actions は、すべてのプッシュとプルリクエストについて、Node.js 20、22、24、26 でテストスイートを実行し、npm の tarball を検証します。Dependabot は毎週、npm と GitHub Actions の依存関係をチェックします。

v* 形式の Git タグをプッシュすると .github/workflows/publish.yml が実行されます。このワークフローは npm のトラステッドパブリッシング（OIDC）を使用し、provenance を自動的に添付します。トラステッドパブリッシャーの設定は次のとおりです。

• GitHub 所有者: unixfox

• リポジトリ: mcp-meteoblue

• ワークフロー: publish.yml

• 環境: npm

トラステッドパブリッシングを設定している場合、npm トークンは GitHub に保存されません。

API スコープ

このサーバーが呼び出すのは次のものだけです。

• https://www.meteoblue.com/{language}/server/search/query3

• https://my.meteoblue.com/packages/{packages}

• https://my.meteoblue.com/images/{forecast-image-type}

meteoblue の History、Dataset、Maps、Measurements、その他の API は公開しません。

ライセンス

MIT