Uk Planning Data

@pipeworx/uk-planning-data

planning.data.gov.uk の英国の計画指定情報。MHCLG の国土計画データプラットフォームから、イングランド内の任意の地点を調べ、その地点を対象とする保全地区、登録建造物、第4条指示、グリーンベルト、ブラウンフィールド用地、洪水リスク区域、樹木保全区域を取得できます。

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

ツール

• ukplanning_datasets(query?, typology?, headline_only?) — データセットカタログです。他のすべてのツールに渡すスラッグに加えて、行数とライセンスを返します。
• ukplanning_entities_at_point(latitude, longitude, dataset?, limit?, include_geometry?) — 指定した緯度・経度を境界に含むすべての指定情報です。「この住所は保全地区／グリーンベルト／洪水区域内か」を調べる、敷地のデューデリジェンス向けの呼び出しです。
• ukplanning_search(dataset?, typology?, reference?, curie?, organisation_entity?, entry_date_year?, limit?, offset?, include_geometry?) — エンティティを絞り込みます。意図的にフリーテキストの検索クエリは受け付けません。詳細は以下をご覧ください。
• ukplanning_entity(entity, include_geometry?) — 数値 ID でエンティティを1つ取得します。

認証

キーは不要です。

データソース

• https://www.planning.data.gov.uk/dataset.json — データセットカタログです。
• https://www.planning.data.gov.uk/entity.json — エンティティ検索と地点検索です。
• https://www.planning.data.gov.uk/entity/{entity}.json — エンティティを1つ取得します。
• https://www.planning.data.gov.uk/openapi.json — パラメーター一覧です。

知っておくとよい点：

• q はドキュメントに記載されていますが、何も機能しません。 ?q=Trafalgar%20Square&limit=3 は count: 25355431、つまりプラットフォーム全体を返し、フィルターなしの呼び出しと同じ3行を返します。この API にフリーテキスト検索はありません。このパックでは、フリーテキスト検索を受け付けず、転送もしません。転送すると、結果セットのような形で2500万行が返ってくるためです。場所で検索するには ukplanning_entities_at_point を使い、絞り込むには dataset／curie／reference／organisation_entity を使ってください。これら4つは実際に絞り込みます（検証済み：reference=CA18 → 31行）。
• ジオメトリは非常に大きくなります。 各行には WKT の MULTIPOLYGON が含まれ、保全地区1つで60 KBになることもあります。ここでのリスト呼び出しは、呼び出し元が明示的に指定しない限り、すべて exclude_field=geometry&exclude_field=point を送信します。
• 地点検索に relation パラメーターは不要です — ?longitude=&latitude= はデフォルトで intersects を使います。すべてのレイヤーを一度に取得するには dataset を省略してください。
• reference は一意ではありません。 公開元独自の ID であるため、「CA18」は31の自治体に一致します。organisation_entity と組み合わせるか、prefix:reference 形式の curie を使ってください。
• レスポンスのフィールド名はハイフン区切り、クエリパラメーター名はアンダースコア区切りです （本文では entry-date、クエリでは entry_date_year）。どちらも上流 API の仕様です。

クイックスタート

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

{
  "mcpServers": {
    "uk-planning-data": {
      "url": "https://gateway.pipeworx.io/uk-planning-data/mcp"
    }
  }
}

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

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

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、このパックでは対応できない質問にも、カタログ全体を対象に振り分ける ask_pipeworx を通じて回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキストの消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに 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/ukplanning_datasets \
  -H 'Content-Type: application/json' \
  -d '{"query":"conservation"}'

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

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

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

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

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

npx -y @pipeworx/mcp-uk-planning-data

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Uk Planning Data data" })

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

詳細

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

ライセンス

MIT