planwire-mcp

PlanWire MCP 服务

在 Claude、Cursor 和任何 MCP 客户端中使用英国规划申请数据。

PlanWire 通过公共 API 提供最新、标准化的英国规划申请数据。此 MCP 服务将该 API 封装为 Agent 工具，让助手能够搜索申请、查看具体记录、查找某个地点附近的申请，并列出受支持的地方议会，无需手动编写 API 调用。

在 https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp 获取免费的沙盒 API 密钥。

什么是 MCP

模型上下文协议（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 获取一条申请记录。
list_councils	列出覆盖的地方议会及其 ID。

提示词示例

• “在 PlanWire 中搜索 Camden 最近的规划申请。”
• “查找过去一年 OX1 被拒的住宅扩建申请。”
• “51.5074, -0.1278 周围 1km 内有哪些规划申请？”
• “列出 PlanWire 覆盖的地方议会。”
• “查找曼彻斯特提及 HMOs 的规划申请。”

限制与定价

免费沙盒密钥适合测试，但每日调用次数和结果大小均有限制。付费方案可提高生产环境的使用限额。

定价：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