planwire-mcp

PlanWire MCP サーバー

Claude、Cursor、およびあらゆる MCP クライアントで英国の都市計画申請データを利用できます。

PlanWire は、最新の正規化された英国の都市計画申請データを公開 API 経由で提供します。この MCP サーバーは、その API をエージェント向けツールとして利用できるようにするため、API 呼び出しを手作業で記述しなくても、アシスタントが申請を検索したり、特定のレコードを確認したり、場所の近くを検索したり、対応している自治体の一覧を取得したりできます。

無料のサンドボックス API キーを https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp で取得できます。

MCP とは

Model Context Protocol（MCP）は、AI ツールが外部サービスを呼び出すための標準規格です。このパッケージは npx 経由でローカルに実行し、ユーザー自身の API キーを使って PlanWire と通信し、構造化された都市計画データを MCP クライアントに返します。

このサーバーは stdio トランスポートを使用します。認証情報を保存したり、ホスト型プロキシを実行したりすることはありません。

インストール

Node.js 18+ と PlanWire API キーが必要です。

npx -y planwire-mcp

パッケージ名は、表示されているとおりに planwire-mcp を使用してください。MCP ディレクトリに beshogun-planwire-mcp のインストールコマンドが表示される場合、そのディレクトリの生成済みメタデータは古く、インストールに失敗します。

サーバーは環境変数 PLANWIRE_API_KEY を必要とします。任意で、PLANWIRE_API_BASE を設定すると、デフォルトの https://api.planwire.io を上書きできます。

Claude Desktop

claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "planwire": {
      "command": "npx",
      "args": ["-y", "planwire-mcp"],
      "env": {
        "PLANWIRE_API_KEY": "your_planwire_key_here"
      }
    }
  }
}

設定を保存したら、Claude Desktop を再起動します。

Claude Code

プロジェクトの .mcp.json に次の設定を追加します。

{
  "mcpServers": {
    "planwire": {
      "command": "npx",
      "args": ["-y", "planwire-mcp"],
      "env": {
        "PLANWIRE_API_KEY": "your_planwire_key_here"
      }
    }
  }
}

Cursor

Cursor の MCP 設定に同じサーバーコマンドを追加します。

{
  "mcpServers": {
    "planwire": {
      "command": "npx",
      "args": ["-y", "planwire-mcp"],
      "env": {
        "PLANWIRE_API_KEY": "your_planwire_key_here"
      }
    }
  }
}

ツール

ツール	機能
search_planning_applications	キーワード、自治体、郵便番号、ステータス、種類、または期間で検索します。
nearby_planning_applications	緯度・経度で指定した地点の近くにある申請を検索します。
get_planning_application	PlanWire の申請 ID を指定して、1件の申請を取得します。
list_councils	対応している自治体とその ID の一覧を取得します。

プロンプトの例

• 「PlanWire で Camden の最近の都市計画申請を検索して。」
• 「過去1年間に OX1 で却下された住宅所有者向け増築申請を探して。」
• 「51.5074, -0.1278 から1km以内にある都市計画申請を教えて。」
• 「PlanWire が対応している自治体を一覧表示して。」
• 「Manchester で HMO に言及している都市計画申請を探して。」

制限と料金

無料のサンドボックスキーはテストに適しており、1日の呼び出し回数と結果サイズに上限があります。有料プランでは、本番利用向けに上限が引き上げられます。

料金：https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp#pricing

トラブルシューティング

ツールに PLANWIRE_API_KEY is not set と表示される場合は、MCP クライアントの設定にキーを追加して、クライアントを再起動してください。

PlanWire が 401 を返す場合は、キーが正しく、有効であることを確認してください。

PlanWire が 429 を返す場合は、キーがレート制限に達しています。呼び出し回数を減らすか、https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp#pricing でアップグレードしてください。

開発

npm install
npm run build
npm start

MIT ライセンスです。PlanWire が開発しました：https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp