Nasa Firms

@pipeworx/nasa-firms

NASA FIRMS による衛星のアクティブ火災検知データ — MODIS または VIIRS が活発に燃焼中として測定した全ピクセルを、衛星の通過から約3時間以内に公開します。

Pipeworx の一部です — AI エージェントを1683以上の稼働中データソースに接続する MCP ゲートウェイです。

ツール

• firms_hotspots_area(bbox, source?, day_range?, date?, limit?) — バウンディングボックス内の検知データです。bbox は度単位のwest,south,east,north、または"world"です。
• firms_hotspots_near(latitude, longitude, radius_km?, source?, day_range?, date?) — 地点周辺の検知データです。distance_kmを含み、近い順に並べ替えられます。
• firms_data_availability(source?) — 各センサー製品が対象とする最初と最後の日付です。過去のデータを問い合わせる前に呼び出してください。結果が空の場合に、「火災がない」のではなく「アーカイブ対象外」と判断できます。

認証

BYO のみです。FIRMS には MAP_KEY が必要で、キーなしまたはデモ用の方法はありません — 2026-09-17 に確認済み：キーなしでは、すべてのルートがInvalid MAP_KEY.（HTTP 400/401）を返します。_apiKeyとして渡してください。プラットフォームのフォールバック環境変数はPLATFORM_NASA_FIRMS_KEYです。

キーはhttps://firms.modaps.eosdis.nasa.gov/api/map_key/で無料で取得でき、メールアドレスがあれば申請でき、承認手続きはありません。制限は10分あたり5,000トランザクションで、複数日にまたがる問い合わせは複数のトランザクションとして数えられます。

データソース

• https://firms.modaps.eosdis.nasa.gov/api/area/csv/{KEY}/{SOURCE}/{BBOX}/{DAYS}[/{DATE}] — ホットスポット検知データです。キーはヘッダーやクエリパラメーターではなく、パスに含めます。
• https://firms.modaps.eosdis.nasa.gov/api/data_availability/csv/{KEY}/{SENSOR} — アーカイブの対象期間です。

次の人が同じことを調べ直さずに済むように

• acq_timeは先頭のゼロが省略されたHHMM形式です。 "52"は00:52Zを意味します。単純に2文字を切り出すと52:00として扱われ、10:00より前の通過時刻はすべて時刻が誤って計算されます。
• 輝度の列名はセンサーによって異なります。 VIIRS はbright_ti4／bright_ti5、MODIS はbrightness／bright_t31を返します。どちらもbrightness_k／bright_t31_kにマッピングされます。
• /api/country/と/api/countries/のルートは無効です。 FIRMS 独自の API インデックスでは「Feature currently not available」と記載され、Invalid API call.（HTTP 400）が返されます。そのため、firms_hotspots_countryは実装していません。国のバウンディングボックスで代用しないでください。たとえばチリを囲むボックスにはアルゼンチンも含まれ、呼び出し元には隣国の火災が指定した国のものとして返されます。firms_hotspots_nearが適切な方法です。
• day_rangeは上流で5に制限されています。 dateが指定されている場合はその日から先に、指定されていない場合は今日から過去に向かって数えます。
• エラーはHTTP 400/401/403でJSONではなく、英語の文のみで返されます。 そのため、レスポンス本文が診断情報となり、そのまま表示されます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "nasa-firms": {
      "url": "https://gateway.pipeworx.io/nasa-firms/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/nasa-firms/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて、共有ツールがおよそ 30 個表示されます。接続の initialize 応答に正確なスコープが記載されており、その日の状況を確認する際の信頼できる情報源です。

これは意図的な仕様であり、誤って多重化しているわけではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を対象にルーティングする ask_pipeworx を介して回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが一覧に直接表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイに接続し、同じ 1683 以上のデータソースを利用できます。異なるのは、どのパックのツールが一覧に直接表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/firms_hotspots_area \
  -H 'Content-Type: application/json' \
  -d '{"bbox":"-125,32,-114,42","source":"VIIRS_SNPP_NRT","day_range":1}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/firms_hotspots_area を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントは不要で、ゲートウェイへの往復通信も発生しません。

{
  "mcpServers": {
    "nasa-firms": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-nasa-firms"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-nasa-firms

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使えますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Nasa Firms data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT