AI导哈

房地产数据MCP服务器

一个集成BatchData.io全面房产和地址API的模型上下文协议(MCP)服务器，提供房产数据、地址验证、跳转追踪、地理编码和高级房产搜索功能。

  • by zellerhaus
  • TypeScript
  • 本地部署
  • 33 星标
  • 更新于
在 GitHub 查看 zellerhaus/batchdata-mcp-real-estate

使用说明

BatchData-房地产数据-MCP服务器

与BatchData.io的全面属性和地址API集成的模型上下文协议（MCP）服务器。此服务器提供对属性数据的访问、地址验证、跳过跟踪、地理编码和高级属性搜索功能。

特性

地址操作

  • 验证地址：使用USPS验证验证和标准化地址
  • 自动补全地址：键入时获取智能地址建议
  • 地理编码地址：将地址转换为纬度/经度坐标
  • 反向地理编码：将坐标转换回可读地址

物业运营

  • 查找属性：通过地址或APN（评估包裹号）获取详细的房产信息
  • 搜索属性：具有全面过滤器的高级房产搜索
  • 按边界搜索属性：使用边界框或半径进行地理边界搜索
  • 计数属性：获取符合特定条件的属性计数（轻量级操作）

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的batchdata mcp real estate 史密瑟里:

npx -y @smithery/cli install @zellerhaus/batchdata-mcp-real-estate --client claude

手动安装

  1. 将此MCP服务器克隆或下载到本地计算机

  2. 安装依赖项:

    cd batchdata-mcp-real-estate
npm install

  3. 配置API密钥:

    BATCHDATA_API_KEY=your_actual_api_key_here

  4. 构建TypeScript项目:

    npm run build

  5. 测试服务器:

    npm start

快速设置

使用自动设置脚本：

Linux/macOS：

chmod +x setup.sh && ./setup.sh

窗户：

setup.bat

Docker支持

Docker快速入门

  1. 构建并测试Docker容器：

    chmod +x docker-manage.sh
./docker-manage.sh test

  2. 使用Docker Compose运行：

    ./docker-manage.sh run

  3. 查看日志：

    ./docker-manage.sh logs

Docker管理命令

这 docker-manage.sh 脚本提供了方便的命令：

  • 构建：构建Docker镜像
  • 跑：从docker compose开始
  • 停止：停止服务
  • 日志：查看服务器日志
  • 测试：构建并测试服务器
  • 清洁：清理Docker资源
  • 直接运行：直接使用Docker运行（用于测试）

Docker使用手册

塑造形象：

docker build -t batchdata-mcp-server:latest .

使用环境文件运行：

docker run --rm --env-file .env batchdata-mcp-server:latest

使用Docker Compose运行：

docker-compose up -d

Docker功能

  • 多阶段构建 用于优化图像大小
  • 非root用户 增强安全性
  • 健康检查 用于监控
  • 资源限制 以及日志记录配置
  • 生产准备就绪 通过适当的信号处理

开发命令

  • 构建: npm run build -将TypeScript编译为JavaScript
  • 开始: npm start -运行编译后的JavaScript服务器
  • 开发: npm run dev -在一个命令中构建和运行
  • 清洁: npm run clean -删除已编译的JavaScript文件

Claude桌面配置

要将此MCP服务器与Claude Desktop一起使用，请将以下内容添加到您的Claude配置文件中：

macOS

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "batchdata": {
      "command": "node",
      "args": ["/path/to/batchdata-mcp-real-estate/batchdata_mcp_server.js"],
      "env": {
        "BATCHDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

视窗

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "batchdata": {
      "command": "node",
      "args": ["C:\\path\\to\\batchdata-mcp-real-estate\\batchdata_mcp_server.js"],
      "env": {
        "BATCHDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude桌面版的Docker配置

如果通过Docker运行，您可以配置Claude Desktop使用容器化服务器：

{
  "mcpServers": {
    "batchdata": {
      "command": "docker",
      "args": ["exec", "-i", "batchdata-mcp-server", "node", "batchdata_mcp_server.js"],
      "env": {
        "BATCHDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

地址工具

  • verify-address -USPS地址验证和标准化
  • autocomplete-address -智能地址建议
  • geocode-address -将地址转换为坐标
  • reverse-geocode -将坐标转换为地址

属性工具

  • lookup-property -按地址/APN列出的详细房产数据
  • search-properties -高级筛选属性搜索
  • search-properties-by-boundary -地理区域搜索
  • count-properties -物业计数查询

示例用法

计算凤凰城的房产

I need to count single-family homes in Phoenix, AZ between $250,000 and $600,000

查找可比房产

Find properties similar to 2800 N 24th St, Phoenix, AZ 85008 within 1 mile

验证地址

Verify this address: 2800 N 24th St, Phoenix, Arizona 85008

API费率限制

每个端点的BatchData.io速率限制：

  • 地址验证：最大5000（建议每批1000）
  • 地址地理编码：最多90（建议每批75）
  • 房产搜索：最多1000个请求
  • 属性查找：API标准限值

环境变量

变量 描述 必填
BATCHDATA_API_KEY 您的BatchData.io API密钥 是

错误处理

该服务器包括全面的错误处理功能，用于：

  • API密钥无效
  • 网络请求失败
  • 请求格式错误
  • API请求频率超限
  • 无效的参数组合

依赖项

  • @模型上下文协议/sdk：核心MCP框架
  • 动物圈：运行时类型验证
  • Dotenv。：环境变量加载
  • 打字稿：TypeScript编译器
  • @类型/节点：Node.js类型定义

贡献

看 贡献.md 用于开发设置和指南。

许可证

MIT许可证-请参阅 许可证 了解详情。

支持

房地产专业人士和开发商：此MCP服务器使Claude能够访问全面的属性数据，执行地址验证，并直接通过自然语言查询进行高级属性搜索。

相关 MCP