Property Price Search MCP Server

Property Price Search MCP Server

site icon
2025.04.05 0
TypeScript房产价格查询数据分析金融服务
Property Price Search MCP Server 是一个基于模型上下文协议(MCP)的服务,允许用户通过邮政编码搜索房产价格,使用HM Land Registry的SPARQL端点。该服务提供了丰富的搜索和过滤功能,支持多种参数查询,并提供了命令行接口和库集成方式。
View on GitHub

Overview

基本能力

产品定位

Property Price Search MCP Server 是一个用于搜索和查询英国房产价格的服务,主要面向需要获取房产市场数据的开发者和数据分析师。

核心功能

  • 通过邮政编码或街道/城市组合搜索房产价格
  • 根据价格范围、房产类型和日期范围过滤结果
  • 连接到HM Land Registry的公共SPARQL端点
  • 实现MCP stdio传输以支持IDE集成
  • 使用TypeScript实现,具有完整的类型安全
  • 提供全面的测试套件
  • 提供命令行接口(CLI)直接使用

适用场景

  • 房产市场数据分析
  • 房产价格趋势研究
  • 房产投资决策支持
  • 房产相关应用的开发

工具列表

  • CLI工具:提供命令行接口直接查询房产价格
  • TypeScript库:可作为库集成到其他应用中

常见问题解答

  1. SPARQL端点连接问题
  2. 检查网络连接
  3. 确认HM Land Registry端点可用
  4. 确保IP未被限速

  5. 邮政编码格式无效

  6. 确保邮政编码格式正确
  7. 移除多余空格
  8. 使用大写字母

  9. 未找到结果

  10. 尝试放宽搜索条件
  11. 检查日期范围是否过窄
  12. 确认邮政编码存在

使用教程

使用依赖

  • Node.js >= 18
  • npm >= 7

安装教程

全局安装

npm install -g property-prices-mcp

本地安装

npm install property-prices-mcp

调试方式

命令行接口

property-prices-mcp

作为库使用

import { McpClient } from '@modelcontextprotocol/sdk/client';

const client = new McpClient();
const result = await client.resource('property-prices').query({
  postcode: 'SW1A 1AA',
  minPrice: 1000000,
  propertyType: 'flat',
  limit: 5,
});

console.log(result);

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。