LTS MCP服务器
A. 模型上下文协议 向LLM提供菲律宾销售许可证(LTS)验证数据的服务器。基于Cloudflare Workers和Supabase构建。
公共、只读、无需身份验证。数据来源于 人类住区和城市发展部(DHSUD) 出售许可证登记处,并与已发布的房地产项目进行交叉引用 任。PH.
为什么存在
法律要求菲律宾房地产开发商在营销或销售公寓单元、细分地块和其他房地产项目之前,必须从DHSUD获得销售许可证(LTS)。买家可以检查项目是否有有效的LTS,但官方验证过程涉及浏览政府网站和手动查找记录。
此MCP服务器使任何LLM都可以查询该数据。询问你的人工智能助手“\[项目名称\]是否有有效的销售许可证?”并获得DHSUD记录支持的答案。
工具
| 工具 | 说明 |
|---|---|
lts_search | 按名称、LTS编号、开发商或城市搜索DHSUD记录和已发布的项目 |
lts_queue | 使用过滤器(状态、地区、到期、分数)浏览DHSUD验证队列 |
lts_project | 获取项目的完整LTS图片(按UUID或名称) |
lts_stats | 系统范围统计数据:队列管道健康状况和项目LTS计数 |
lts_check | 检查系统中是否存在特定的LTS编号 |
lts_filters | 获取可用于过滤的地区和城市 |
工具详情
lts_search 是普遍的切入点。它搜索DHSUD验证队列(抓取的记录)和REN。PH项目数据库同时进行。当您有项目名称、开发人员姓名、LTS编号或城市,并想找到所有相关信息时,请使用此选项。
lts_queue 允许访问原始DHSUD抓取数据。每条记录代表DHSUD注册表中的一个LTS条目,匹配状态指示它是否已链接到REN中的项目。PH数据库。支持按匹配状态、地区、最低匹配分数、文本搜索和即将过期的窗口进行筛选。
lts_project 返回单个项目的完整LTS图片:所有具有计算字段的LTS记录(is_expired, days_until_expiry),包含计数(已验证、已过期、即将过期)和主要LTS编号的摘要。接受项目UUID或项目名称进行模糊查找。
lts_stats 返回两个部分:来自验证管道的队列统计数据(总记录、待定、自动匹配、手动匹配、不匹配、过期、即将过期)和项目LTS统计数据(已验证、过期、30天内过期、具有活动LTS的项目的总记录)。
lts_check 验证是否存在特定的LTS编号。返回它是否在DHSUD队列中、在验证的项目LTS表中或两者中找到,以及完整的记录详细信息。
lts_filters 返回验证队列中可用的不同地区和城市。打电话前使用此功能 lts_queue 使用地区或城市过滤器来获取有效值。可选择通过一个地区,只获取该地区内的城市。
响应格式
所有数据响应都封装在标准元数据信封中:
{
"_meta": {
"source": "Department of Human Settlements and Urban Development (DHSUD)",
"source_url": "https://dhsud.gov.ph/",
"dataset": "License to Sell (LTS) Registry",
"last_synced": "2026-03-04"
},
"data": { ... }
}错误响应(isError: true)以无换行的纯文本形式返回。
分页响应
返回列表的工具(lts_search, lts_queue)使用标准分页包装器:
| 字段 | 类型 | 描述 |
|---|---|---|
items | array | 结果记录 |
total | number | 匹配记录总数 |
limit | number | 使用的页面大小 |
offset | number | 当前偏移量 |
hasMore | boolean | 是否存在更多结果 |
LTS状态值
| 状态 | 含义 |
|---|---|
verified | LTS通过验证过程确认有效 |
unverified | LTS存在但尚未验证 |
expired | LTS过期 |
none | 项目没有LTS记录 |
匹配状态值(队列)
| 状态 | 含义 |
|---|---|
pending | DHSUD记录等待审查 |
auto_matched | 自动链接到项目 |
manual_matched | 由审阅者手动链接 |
no_match | 未找到匹配的项目 |
skipped | 复习时跳过 |
new_project | 记录显示数据库中尚未有新项目 |
连接
添加到MCP客户端配置中:
{
"mcpServers": {
"lts": {
"url": "https://lts.godmode.ph/mcp"
}
}
}快速测试
curl -X POST https://lts.godmode.ph/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "lts_check",
"arguments": { "ltsNumber": "HLURB-LTS-0001-2024" }
}
}'数据源
| 来源 | 描述 |
|---|---|
| DHSUD LTS注册表 | 报废销售许可证记录:LTS编号、项目名称、开发商、城市、发行/到期日期 |
| 任。PH | 已发布的房地产项目数据库,具有经过验证的LTS链接 |
DHSUD验证队列包含从DHSUD公共注册表中抓取的记录。这些记录与REN相匹配。PH的项目数据库结合了精确的LTS编号匹配、项目名称匹配和模糊评分。经过验证的匹配项存储在 project_lts 有完整出处的桌子。
最后同步时间:2026年3月4日。
安全
这是一个公共的只读端点。Supabase连接使用匿名密钥(不是服务角色密钥),所有数据访问都是通过行级安全(RLS)策略强制执行的:
projects:只有已发布的项目可见project_lts:所有已验证/公开的LTS记录都是可见的lts_verification_queue:所有DHSUD公共数据可见
即使Worker受到攻击,攻击者也只能读取RLS允许的内容。未公开任何写入操作。
什么是销售许可证?
根据菲律宾法律(警察957 和 BP 220)房地产开发商必须确保 销售许可证(LTS) DHSUD在向公众出售任何细分地块、公寓单元或类似房地产项目之前。LTS确认该项目已通过审查,符合分区、土地使用、环境和发展标准。
从没有有效LTS的项目中购买是菲律宾房地产最常见的风险之一。此MCP服务器使AI助手、聊天机器人和任何兼容MCP的应用程序都可以访问该验证。
相关项目
菲律宾公共数据MCP服务器套件的一部分:
- PSGC-MCP -菲律宾标准地理代码数据
- ts MCP (此回购)-DHSUD销售许可证验证
- PH假期MCP -即将推出
- BSP银行目录MCP -即将推出
所有服务器都是免费的、公共的、只读的。数据来自菲律宾政府官方消息来源。
发展
npm install
npm run cf-typegen
npm run devcf-typegen 生成 worker-configuration.d.ts (gitignored)与Cloudflare运行时类型。克隆后运行一次,更改后再次运行 wrangler.jsonc.
开发服务器启动时间 http://localhost:8787。将您的MCP客户端连接到 http://localhost:8787/mcp.
测试
npm test # run all tests
npm run test:watch # watch mode4个套件中的88个测试,涵盖了净化(PostgREST过滤器注入)、实用函数、响应格式和使用模拟Supabase客户端的查询逻辑。
部署
在首次部署之前,设置Supabase机密:
npx wrangler secret put SUPABASE_URL
npx wrangler secret put SUPABASE_ANON_KEY然后部署:
npm run deploy类型生成
变更后 wrangler.jsonc:
npm run cf-typegen贡献和问题
发现数据不符或项目的LTS状态不正确?打开一个问题。DHSUD数据会定期被抓取,并与REN进行匹配。PH数据库。通过问题跟踪匹配管道中的不匹配、缺失记录和边缘情况。
如果数据看起来过时,打开一个问题,它将在下一次计划同步之前刷新。
建造于
亚伦·扎拉 -CTO分数 Godmode数码
建造 任。PH,一个程序化的房地产平台,拥有60000多个结构化页面,覆盖菲律宾的每个省、市和镇。LTS MCP的出现是因为需要让人工智能代理可以访问DHSUD许可证验证,因为买家在签署任何东西之前都应该知道一个项目是否获得了许可。
对于企业SLA、自定义集成或其他PH数据源: godmode.ph
许可证
麻省理工学院
