Worldpop

@pipeworx/worldpop

WorldPop（サウサンプトン大学）の100 mグリッド人口推計データ（2000～2020年）を、指定した任意のポリゴン上で合計します。国勢調査の表では公式の行政区画単位でしか答えられない「この境界内には何人が住んでいるか」という問いに、集水域、洪水範囲、サービスエリアなど、任意のジオメトリを使って答えます。

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

ツール

• worldpop_stats_polygon(geojson, year?, dataset?, runasync?) — GeoJSON Polygon／MultiPolygon内の総人口です。
• worldpop_datasets() — 統計サービスが公開している人口サーフェスです。
• worldpop_task_status(taskid) — 1つの非同期ジョブの状態と結果です。

認証

キーは不要です。WorldPopは、登録不要で、公正な利用（1日あたりおよそ1,000回の呼び出し）を求めています。

データソース

• https://api.worldpop.org/v1/services — データセット一覧（wpgppop は人口数、wpgpas は年齢と性別の構成）。
• https://api.worldpop.org/v1/services/stats — ポリゴンジョブを送信します。
• https://api.worldpop.org/v1/tasks/{taskid} — 結果を取得します。

このパックは、次の2つの注意点を吸収します。

統計呼び出しは非同期で、どちらの場合も200を返します。 送信すると、人口データを含まない{"status":"created","taskid":...}が返されます。これを回答として読み取る呼び出し元には、何も通知されないままゼロが返されます。worldpop_stats_polygonは、statusがfinishedになるまで/tasks/{id}をポーリングし（12回、約1.5秒間隔。都市規模のポリゴンは約3秒で完了します）、いずれの場合もtaskidを返すため、ポーリング時間が切れても情報は失われません。

GeoJSONのFeatureは拒否されます。 WorldPopのバリデーターは裸のジオメトリのみを受け付け、"Invalid GeoJSON: ... is not valid under any of the given schemas"を返します。これはHTTPエラーではなく、タスク上で200とerror: trueとして返されます。マッピングツールはすべてFeatureを返すため、呼び出し前にnormaliseGeometryがFeatureとFeatureCollectionを取り出します。

クイックスタート

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

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

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

https://gateway.pipeworx.io/worldpop/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も同じゲートウェイと同じ1684以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworxは、どちらからでもすべてのツールにアクセスできます。

MCPクライアントがなくても、HTTP経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/worldpop_stats_polygon \
  -H 'Content-Type: application/json' \
  -d '{"geojson":{"type":"Polygon","coordinates":[[[-0.14,51.5],[-0.1,51.5],[-0.1,51.53],[-0.14,51.53],[-0.14,51.5]]]},"year":2020}'

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

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

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

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

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

npx -y @pipeworx/mcp-worldpop

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Worldpop data" })

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

詳細

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

ライセンス

MIT