Global Forest Watch

@pipeworx/global-forest-watch

Global Forest Watch Data API（WRI / UMD）— GFW を支えるカタログおよびクエリインターフェースです。年間の樹冠被覆損失・増加、原生林の範囲、GLAD および RADD の森林減少アラート、VIIRS/MODIS の火災アラート、炭素フラックス、保護地域、コンセッション、Aqueduct の水リスクを提供します。

Pipeworx の一部です。AI エージェントを 1879 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

• gfw_datasets(query?, limit?, page?) — カタログを一覧表示、またはキーワードで検索します（2026-09 時点で 382 データセット）。query を指定すると、カタログ全体を検索し、上流のページ数は最大 5 ページに制限されます。キーは不要です。
• gfw_dataset(dataset, version?) — 1 つのデータセットのメタデータ（ソース、引用、解像度、対象範囲、更新頻度、注意事項、ライセンス）とバージョン一覧を取得します。バージョンを指定すると、そのバージョンのステータス、アセット、フィールド／バンド一覧も取得します。キーは不要です。
• gfw_query(dataset, sql, version?, limit?, _apiKey) — 1 つのデータセットバージョンに対して、読み取り専用の SELECT を実行します。呼び出し元のキーが必要です。

認証

カタログの閲覧はキー不要であることを確認済みです（2026-09-17）。/query エンドポイントには x-api-key が必要で、キーがない場合は 403 "Request is missing valid API key" が返されます。

プラットフォームキーは設定されていません。キーが利用可能になった場合に使用する想定の環境変数は PLATFORM_GFW_KEY です。https://globalforestwatch.org で登録し、データ API で POST /auth/token、続いて POST /auth/apikey を実行してキーを発行してください。

キーが設定されていない間は、platformKeyEnv を意図的に宣言していません。理由は copernicus-cds と同じです。README の Auth セクションを参照してください。シークレットを設定する変更と同時に追加してください。

データソース

• https://data-api.globalforestwatch.org/datasets — カタログです。ページ指定には page[number] / page[size]（JSON:API スタイルの角括弧）を使用します。レスポンスには meta.total_items と meta.total_pages が含まれます。
• https://data-api.globalforestwatch.org/dataset/{d} — データセットのメタデータです。
• https://data-api.globalforestwatch.org/dataset/{d}/{version} — バージョンのメタデータです。latest は有効なバージョンエイリアスですが、307 リダイレクトされて具体的なバージョンに移動するため、取得時にはリダイレクトに従う必要があります。-L を付けない通常の curl では、本文が空の 307 が返され、障害が発生しているように見えます。
• https://data-api.globalforestwatch.org/dataset/{d}/{version}/fields — 列／バンドです。ラスターのデータセットでは、列名は name ではなく pixel_meaning に含まれます。
• https://data-api.globalforestwatch.org/dataset/{d}/{version}/query — SQL です。 テーブル名は常に data です。

クイックスタート

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

{
  "mcpServers": {
    "global-forest-watch": {
      "url": "https://gateway.pipeworx.io/global-forest-watch/mcp"
    }
  }
}

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

https://gateway.pipeworx.io/global-forest-watch/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール — ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式 — も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールとともに、共有ツールが約 30 個一覧表示されます。接続の initialize レスポンスには正確なスコープが示され、その日の状況を確認する際の正式な情報となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックでは対応できない質問にも、カタログ全体を横断してルーティングする ask_pipeworx を通じて答えられます。そのため、MCP サーバーを 2 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマに必要なコンテキストが、ルーティングによる利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度接続してください。

すべてのパックのツールを一覧で直接表示するには、このパックだけでなく、Pipeworx ゲートウェイ全体に接続してください。

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

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

MCP クライアントがない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/gfw_datasets \
  -H 'Content-Type: application/json' \
  -d '{"query":"tree cover loss","limit":5}'

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

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

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

{
  "mcpServers": {
    "global-forest-watch": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-global-forest-watch"]
    }
  }
}

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

npx -y @pipeworx/mcp-global-forest-watch

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Global Forest Watch data" })

ゲートウェイが適切なツールを選び、引数を自動で入力します。

詳細

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

ライセンス

MIT