JinDaGe - mcp MCP Details

article

README

🚀 Propbar MCP 服务器

Propbar MCP 服务器为 AI 助手提供 英国房产研究工具。它能让 Claude、GPT 等大语言模型搜索房产信息、分析区域安全性、查找附近学校、探索人口统计数据，还能 构建自动估值模型（AVM）。

该服务器由 Propbar 全面的英国房产数据库提供支持，涵盖 3000 多万套房产。

🚀 快速开始

Claude 桌面端

将以下内容添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "propbar": {
      "url": "https://mcp.propbar.co.uk"
    }
  }
}

首次连接时，系统会提示你通过 OAuth 进行身份验证。

编程式访问

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'

const transport = new StreamableHTTPClientTransport(
  new URL('https://mcp.propbar.co.uk'),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
      },
    },
  }
)

const client = new Client({ name: 'my-app', version: '1.0.0' })
await client.connect(transport)

// 获取用于估值的可比房产
const result = await client.callTool('get_comparables', {
  coordinates: { latitude: 51.5074, longitude: -0.1278 },
  propertyType: 'flat',
  bedrooms: 2,
  radiusKm: 1,
  transactionType: 'sale'
})

✨ 主要特性

提供全面的英国房产研究工具，支持 Claude、GPT 等大语言模型。
可用于构建自动估值模型（AVM），提供 50 多个可过滤字段的房产搜索。
为购房者提供综合的区域数据，包括犯罪与安全、学校、人口统计和市场分析。

📦 安装指南

订阅：需要专业版或高级版订阅。
账户：在 propbar.co.uk 注册

💻 使用示例

获取用于估值的可比房产

{
  "tool": "get_comparables",
  "arguments": {
    "coordinates": { "latitude": 51.5074, "longitude": -0.1278 },
    "propertyType": "flat",
    "bedrooms": 2,
    "radiusKm": 1,
    "transactionType": "sale"
  }
}

返回结果：近期销售的房产、已达成销售协议的房产以及当前挂牌的房产，包含价格、日期、建筑面积、能源性能证书（EPC）评级和房产门户网站链接等信息。

检查区域安全性

{
  "tool": "get_crime_stats",
  "arguments": {
    "latitude": 53.958,
    "longitude": -1.080
  }
}

查找附近学校

{
  "tool": "get_schools",
  "arguments": {
    "latitude": 53.9583,
    "longitude": -1.0803,
    "radiusMetres": 2000
  }
}

获取人口统计数据

{
  "tool": "get_demographics",
  "arguments": {
    "areaCode": "E06000014",
    "topics": ["ageBands", "ethnicGroup", "tenure"]
  }
}

📚 详细文档

使用案例

构建自己的自动估值模型（AVM）

get_comparables 工具提供 全面的房产搜索，拥有 50 多个可过滤字段，非常适合构建自动估值模型：

交易数据：包含销售日期和金额的销售历史、当前挂牌价格
市场状态：待售、已达成销售协议、已接受报价、已预订、重新挂牌日期
房产属性：类型、卧室数量、浴室数量、建筑面积、建造年代
EPC 数据：能源评级（A - G）、能效得分、潜在评级
产权与费用：永久产权/租赁产权、剩余租赁年限、服务费、地租
定价指标：每平方米价格、每平方英尺价格、随时间的价格变化
挂牌信息：挂牌天数、降价情况、房产门户网站链接

示例 AVM 工作流程：

1. get_comparables({ latitude, longitude, propertyType: "flat", bedrooms: 2 })
2. 按销售日期（过去 12 个月）和距离进行过滤
3. 对差异进行调整（建筑面积、EPC 评级、房屋状况）
4. 计算每平方英尺价格并应用于目标房产

购房者的房产研究

帮助用户利用全面的区域数据做出明智的决策：

犯罪与安全：该区域安全吗？与其他区域相比如何？
学校：附近有哪些学校？学校的教育标准办公室（Ofsted）评级如何？
人口统计：这里居住的是哪些人？年龄、产权类型、家庭类型如何？
市场分析：类似房产的售价是多少？

可用工具

| 工具 | 描述 | 输入 | |------|-------------|-------| | search_areas | 按名称或邮政编码搜索英国区域 | 查询词 | | search_properties | 按地址搜索英国房产 | 查询词 | | get_area_details | 获取坐标和区域代码 | 区域代码或路径 | | get_crime_stats | 获取犯罪统计数据和安全评级 | 区域代码或经纬度 | | get_schools | 获取带有 Ofsted 评级的学校信息 | 区域代码或经纬度 | | get_demographics | 获取人口普查的人口统计数据 | 区域代码或经纬度 | | get_property_basic | 获取房产基本信息 | 房产 ID | | get_property_full | 获取带有历史信息的完整房产信息 | 房产 ID | | get_comparables | 用于估值的可比房产 | 经纬度 + 过滤器 |

可比房产搜索字段

get_comparables 工具会查询一个包含 56 个可过滤字段 的 Elasticsearch 索引：

房产属性

| 字段 | 描述 | |-------|-------------| | build.propertyType | 独立式住宅、半独立式住宅、联排别墅、公寓等 | | roomDetails.beds | 卧室数量 | | roomDetails.baths | 浴室数量 | | build.totalFloorArea | 总建筑面积（平方米） | | build.constructionAge.* | 建造年份/建造时期 | | tenure.type | 永久产权、租赁产权、共有产权 | | councilTax.taxBand | 市政税等级（A - H） |

定价与销售

| 字段 | 描述 | |-------|-------------| | pricing.currentSale | 当前挂牌销售价格 | | pricing.currentRent | 当前挂牌出租价格（每月） | | saleHistory.date | 历史销售日期 | | saleHistory.amount | 历史销售价格 | | marketStatus.pricePerSqm | 每平方米价格 | | marketStatus.pricePerSqft | 每平方英尺价格 |

市场状态

| 字段 | 描述 | |-------|-------------| | marketStatus.forSale | 当前是否挂牌出售 | | marketStatus.forRent | 当前是否挂牌出租 | | marketStatus.sstcDate | 已达成销售协议日期 | | marketStatus.underOfferDate | 已接受报价日期 | | marketStatus.reservedDate | 已预订日期（出租） | | marketStatus.lastOTM | 最后一次挂牌日期 | | marketStatus.backOTM | 重新挂牌标志 |

EPC 与能源

| 字段 | 描述 | |-------|-------------| | epc.currentRating | 当前 EPC 评级（A - G） | | epc.potentialRating | 潜在 EPC 评级 | | epc.currentEfficiency | 当前能效得分（1 - 100） | | epc.potentialEfficiency | 潜在能效得分 |

租赁产权与费用

| 字段 | 描述 | |-------|-------------| | leaseYearsRemaining | 剩余租赁年限 | | charges.serviceCharge.current | 年度服务费 | | charges.groundRent.current | 年度地租 |

挂牌信息与情报

| 字段 | 描述 | |-------|-------------| | listings.* | 完整的挂牌数据（嵌套） | | listings.publishedDate | 挂牌日期 | | listings.removedDate | 撤牌日期 | | listings.priceChange | 价格变化历史 |

工具工作流程

┌─────────────────────┐     ┌─────────────────────┐
│   search_areas      │     │  search_properties  │
│   (get areaCode)    │     │  (get propertyId)   │
└─────────┬───────────┘     └──────────┬──────────┘
          │                            │
          ▼                            ▼
┌─────────────────────┐     ┌─────────────────────┐
│  Area Tools:        │     │  Property Tools:    │
│  • get_crime_stats  │     │  • get_property_*   │
│  • get_schools      │     │  • get_comparables  │
│  • get_demographics │     │                     │
└─────────────────────┘     └─────────────────────┘

灵活输入：大多数工具可以接受 areaCode 或 latitude/longitude 坐标作为输入。

OAuth 发现

受保护资源元数据（RFC 9728）：

https://mcp.propbar.co.uk/.well-known/oauth-protected-resource

数据来源

房产数据：Propbar - 拥有 3000 多万套英国房产的销售历史、挂牌信息和 EPC 数据。
犯罪统计数据：英国警方 - 按地理位置提供的月度犯罪数据。
学校信息：学校信息查询 - Ofsted 评级、学校类型。
人口统计数据：2021 年英国人口普查 - 人口、家庭、产权类型。

支持

网站：propbar.co.uk
邮箱：hello@propbar.co.uk
GitHub：Propbar/mcp

🔧 技术细节

端点：https://mcp.propbar.co.uk
传输协议：可流式传输的 HTTP（MCP 2025 - 03 - 26）
身份验证：通过 Supabase 使用 OAuth 2.1 进行身份验证

📄 许可证

专有许可证 - 需要有效的 Propbar 订阅。

关键词：英国房产 API、自动估值模型、AVM、房产可比数据、房价数据、EPC 评级、英国房价、房产市场分析、MCP 服务器、人工智能房产工具、土地注册处数据

为 AI 助手提供的英国房产研究和估值工具。

mcp