关于 permits
permits 是 AddressIntel 的只读 MCP 服务,将旧金山半岛的建筑许可和地块可开发性数据提供给 MCP Agent。它涵盖 SB 9、ADU、重建线索及房产分析。
主要功能
- 01按地址或城市搜索建筑许可
- 02筛选 SB 9 可拆分地块
- 03查找 ADU 建设线索
- 04识别重建与扩建机会
- 05查看房产评分和可比成交
适用场景
- 01查找 Menlo Park 的拆除许可
- 02筛选符合 SB 9 条件的挂牌房产
- 03评估地块的 ADU 容量
- 04比较房产重建潜力
MCP 相关
作为只读 MCP 服务,它向客户端提供许可搜索、地块筛选、市场信号及房产情报工具。所有工具通过 AddressIntel API 执行 GET 请求,不提供写入操作。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y addressintel-mcpADDRESSINTEL_API_KEY密钥AddressIntel API key. Optional: without one the server uses the public demo tier (10 requests/minute, 5 rows per call). Free keys at https://addressintel.co/developers本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
6收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 否 | 用于匹配地址、项目类型、工程范围说明、承包商、建筑师和许可证编号的关键词,例如 'demolition' 或 '123 Main St'。 |
| city | string | 否 | 城市名称,例如 'Menlo Park'。支持部分匹配。 |
| limit | number | 否 | 要返回的最大行数。上限受你的 API 密钥等级限制。 |
| offset | number | 否 | 分页的行偏移量。 |
| minValuation | number | 否 | 仅返回估值达到或超过此美元金额的许可证。 |
详细介绍
AddressIntel MCP 服务
一个只读的 Model Context Protocol 服务,可将旧金山半岛的建筑许可和地块可建性数据接入 Claude、ChatGPT 或任何支持 MCP 的 Agent。
它是对公开 AddressIntel API 的轻量客户端,因此遵循该 API 的身份验证、速率限制和套餐上限。所有工具都使用 GET。这里的任何内容都无法写入数据。
工具
| 工具 | 可解答的问题 |
|---|---|
search_permits | 某个地址或城市实际获批了哪些建设项目?可按城市、关键词(地址、项目类型、范围说明、承包商、建筑师、许可证编号)和最低估值进行筛选。 |
list_sb9_inventory | 哪些在售房源可根据 SB 9 拆分或改建为双拼住宅?哪些因素会阻止其他房源这样做? |
list_adu_leads | 哪些地块有空间建造 ADU?可建多少个单元/多少平方英尺? |
list_redevelopment_leads | 哪些地块的现有开发规模低于允许的建筑体量(拆除重建或扩建)? |
list_market_signals | 哪些房源的拆除重建或翻新转售潜力得分最高? |
get_property_intelligence | 查询一个房产 ID 的完整评分和可比成交数据。 |
许可证和地块工具是差异化功能:提供半岛地区的许可证级详情和地块级可建性数据,而不是全国范围的业主名单。
安装
无需安装步骤:npx 会按需获取。
Claude Code
claude mcp add addressintel \
-e ADDRESSINTEL_API_KEY=your_key \
-- npx -y addressintel-mcp
Claude Desktop
添加到 claude_desktop_config.json:
{
"mcpServers": {
"addressintel": {
"command": "npx",
"args": ["-y", "addressintel-mcp"],
"env": {
"ADDRESSINTEL_API_KEY": "your_key"
}
}
}
}
从源代码构建
如需开发服务本身:
git clone https://github.com/RantumBits/addressintel-mcp.git
cd addressintel-mcp
npm install
npm run build # emits dist/index.js
然后,将客户端指向 node /absolute/path/to/addressintel-mcp/dist/index.js,而不是上文的 npx 命令。
重启客户端,然后可以询问类似 “今年 Menlo Park 批准了哪些拆除许可证?” 或 “Palo Alto 哪些在售房源符合 SB 9 条件?” 的问题。
配置
| 变量 | 默认值 | 说明 |
|---|---|---|
ADDRESSINTEL_API_KEY | demo | 未提供密钥时,服务使用公开演示套餐:每分钟 10 次请求,每次调用返回 5 行。在 https://addressintel.co/developers 免费获取密钥,即可获得每分钟 30 次请求和每次 25 行;密钥会发送到你输入的地址。 |
ADDRESSINTEL_API_BASE | https://addressintel.co/api | 开发 API 时,可指向本地开发服务(http://localhost:3000/api)。 |
开发
npm run dev # run from source over stdio
node test_mcp.mjs # smoke test: connect, list tools, call one
工具统一在 src/index.ts 的一张表中声明。每个条目都将 zod 架构和对外提供的 JSON Schema 并列放置,因此添加工具只需添加一个条目,且两种结构不会出现偏差。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。