nyrezone-mcp

nyrezone-mcp

只读 MCP 服务，为 AI 助手提供来自 NYRezone 公共数据的纽约市分区信息：税务地块所属的分区、已建与允许的 FAR、地块和建筑面积、预估未使用的楼面面积，以及各分区的规则。

它只提供已公开且无需身份验证的数据。不包含业主姓名、评估价值、付费报告数据或账户访问权限。

安装

需要 Node 20+。

npx -y nyrezone-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "nyrezone": { "command": "npx", "args": ["-y", "nyrezone-mcp"] }
  }
}

Claude Code

claude mcp add nyrezone -- npx -y nyrezone-mcp

工具

所有工具均为只读（readOnlyHint: true）。

工具	输入	返回内容
lookup_lot	address（以门牌号开头，包含行政区）或 bbl（10 位行政区-街区-地块编号）	分区、叠加区和特别分区、已建 FAR 与最大 FAR、地块面积、建筑面积、预估未使用的楼面面积、建成年份、土地用途。输入模糊或未知时会返回错误，不会猜测。
get_zoning_district	code，例如 R6A、C4-2、M1-2/R6A	NYRezone 发布的 FAR、高度规则和奖励，全市地块数量、平均已建 FAR。未知代码会返回有效代码列表。
list_zoning_districts	可选的 family，例如 R6	NYRezone 记录的 51 个分区，以及每个分区所属分区系列的说明。

每条结果末尾都会附带来源信息（NYRezone 标注的 MapPLUTO 版本、对应的 nyrezone.com 页面，以及地块查询的 Full report 链接）和免责声明。

不包含：按行政区汇总的“未充分开发”情况。NYRezone 只将此类信息发布为网页，没有提供数据接口。

示例

使用 bbl: "3052410015" 调用 lookup_lot，部分返回内容包括：分区为 R7A，地块面积为 4,675 sq ft，建筑面积为 2,606 sq ft，已建 FAR 为 0.56，住宅最大 FAR 为 4.0，预估有 16,094 sq ft 未使用。

未使用楼面面积的估算方式

最大 FAR x 地块面积 - 现有建筑面积，使用 MapPLUTO 的住宅 FAR（若没有住宅 FAR，则使用商业或社区设施 FAR）。这只是初步筛查数值，不考虑街道宽度、特别分区、叠加区、跨分区地块、已划定街道，或 City of Yes / Universal Affordability Preference 奖励。如果建筑已超过最大值，工具会报告 0，并注明该地块已超建。

数据来源和离开你设备的数据

• nyrezone.com（/api/pluto、/zoning、/zoning/<code>、/methodology）：地块数据和分区页面。数据来自 NYC DCP MapPLUTO；版本信息取自 NYRezone 自己的方法说明页面。
• NYC Planning Labs Geosearch（geosearch.planninglabs.nyc）：仅用于将街道地址转换为 BBL，因为 NYRezone 没有地址接口。这是唯一的第三方主机；你查询的地址会发送到该主机。查询 BBL 和分区时不会联系该主机。

NYRezone 地块 API 返回的业主姓名和业主类型会在本服务中被丢弃，绝不会出现在工具结果中。

限制和礼貌使用

• 使用描述性 User-Agent（nyrezone-mcp/<version> (+repo URL)）。
• 请求按顺序发送，间隔至少 1 秒；每分钟最多向上游发送 20 个请求；超时时间为 10 秒，响应大小上限为 2 MB。
• 响应缓存在内存中 1 小时（不会持久化）。
• 发送任何请求前都会验证输入：地址长度为 5–150 个字符，且以门牌号开头；BBL 必须为以 1–5 开头的 10 位数字。发送到上游的所有内容都会进行 URL 编码。

免责声明

仅供参考，不构成法律、建筑或分区合规建议。请先向 NYC Department of City Planning 或持证专业人士确认，再据此采取行动。本项目与纽约市政府无关联。

开发

npm install
npm test        # builds, then runs node:test against recorded fixtures (no live network)

fixtures/ 中的固定样例记录了公开响应；地块固定样例特意保留了原始所有者字段，以便测试验证这些字段会被移除。环境变量 NYREZONE_MCP_BASE_URL、NYREZONE_MCP_GEOSEARCH_URL 和 NYREZONE_MCP_MIN_INTERVAL_MS 仅用于端到端测试。

许可证

MIT。请参阅 LICENSE。