AEMET

aemet-mcp

AEMET（スペイン国家気象庁）が公開する気象データを、AI エージェントおよび MCP 対応クライアントに提供する MCP サーバーです。

AEMET 公式 OpenData API を利用した、型が明確な 3 つのツールを提供します。

• get_municipality_forecast — スペインの自治体の INE コードを指定して、最大 7 日間の日別予報を取得します。
• get_station_observation — 気象観測所の直近約 12 時間分の毎時観測データ（気温、風、降水量など）を取得します。
• get_weather_warnings — 地域またはスペイン全土の有効な気象警報（CAP アラート）を取得します。

前提条件

• Node.js 20+
• 無料の AEMET OpenData API キー：次の URL から申請してください。 https://opendata.aemet.es/centrodedescargas/altaUsuario

インストール

インストールは不要です。npx で直接実行できます。

npx -y @mmillan76/aemet-mcp

このサーバーは stdio で通信するため、ターミナルで単独実行するのではなく、MCP クライアントから起動することを想定しています。

設定

サーバーは AEMET_API_KEY 環境変数から API キーを読み取ります。キーが設定されていない場合、起動時にエラーで終了します。

Claude Desktop / Claude Code

MCP クライアントの設定（例：claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "aemet": {
      "command": "npx",
      "args": ["-y", "@mmillan76/aemet-mcp"],
      "env": {
        "AEMET_API_KEY": "your-api-key-here"
      }
    }
  }
}

stdio サーバーに対応する他の MCP クライアントでも同様に動作します。環境変数に AEMET_API_KEY を設定し、npx -y @mmillan76/aemet-mcp を指定してください。

ローカル開発

git clone https://github.com/mmillan76/aemet-mcp.git
cd aemet-mcp
npm install
cp .env.example .env   # fill in AEMET_API_KEY
npm run build

MCP Inspector を使って、ツールの呼び出しを対話的にテストできます。

npx @modelcontextprotocol/inspector node dist/index.js

（Inspector はシェル環境から AEMET_API_KEY を読み取るため、上記のコマンドを実行する前に環境変数をエクスポートするか、.env を読み込んでください）

AEMET API に関する注意事項

AEMET OpenData は、すべてのエンドポイントで 2 段階の方式を採用しています。最初のリクエストでは実際のデータではなく、datos URL を含む JSON エンベロープが返されます。その URL に 2 回目のリクエストを送ると、実際のペイロードが返されます。このサーバーではこの詳細を隠蔽しており、ツールは最終的なデータのみを返します。API キーごとにレート制限が適用されます。制限に達した場合、ツールは暗黙に再試行するのではなく、明確なエラーを返します。

ライセンス

MIT — LICENSE を参照してください。