JinDaGe - batchdata-mcp-real-estate MCP Details

article

README

🚀 BatchData MCP 服务器

BatchData MCP 服务器是一个集成了 BatchData.io 全面的房产和地址 API 的模型上下文协议（MCP）服务器。该服务器提供房产数据访问、地址验证、跳过追踪、地理编码以及高级房产搜索等功能。

🚀 快速开始

使用自动化设置脚本：

Linux/macOS：

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

Windows：

setup.bat

✨ 主要特性

地址操作

verify-address：使用美国邮政服务（USPS）验证来验证和标准化地址。
autocomplete-address：在您输入时提供智能地址建议。
geocode-address：将地址转换为经纬度坐标。
reverse-geocode：将坐标转换回可读地址。

房产操作

lookup-property：通过地址或评估包裹编号（APN）获取详细的房产信息。
search-properties：使用综合过滤器进行高级房产搜索。
search-properties-by-boundary：使用边界框或半径进行地理边界搜索。
count-properties：获取符合特定条件的房产数量（轻量级操作）。

📦 安装指南

将此 MCP 服务器克隆或下载到本地机器

安装依赖项：

cd batchdata-mcp-real-estate
npm install

配置 API 密钥：
- 从 BatchData 设置获取 API 密钥，或在此注册。
- 在项目根目录创建或更新 .env 文件：
```
BATCHDATA_API_KEY=your_actual_api_key_here
```
构建 TypeScript 项目：
```
npm run build
```
测试服务器：
```
npm start
```

📚 详细文档

开发命令

构建：npm run build - 将 TypeScript 编译为 JavaScript。
启动：npm start - 运行编译后的 JavaScript 服务器。
开发：npm run dev - 一个命令完成构建和运行。
清理：npm run clean - 删除编译后的 JavaScript 文件。

为 Claude Desktop 进行配置

要在 Claude Desktop 中使用此 MCP 服务器，请在 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"
      }
    }
  }
}

Windows

编辑 %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"
      }
    }
  }
}

可用工具

地址工具

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

房产工具

lookup-property - 通过地址/APN 获取详细的房产数据
search-properties - 高级过滤房产搜索
search-properties-by-boundary - 地理区域搜索
count-properties - 房产数量查询

API 速率限制

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

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

环境变量

| 属性 | 详情 | |------|------| | BATCHDATA_API_KEY | 您的 BatchData.io API 密钥 |

错误处理

服务器包含全面的错误处理，可处理以下情况：

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

依赖项

@modelcontextprotocol/sdk：核心 MCP 框架
zod：运行时类型验证
dotenv：环境变量加载
typescript：TypeScript 编译器
@types/node：Node.js 类型定义

💻 使用示例

统计菲尼克斯的房产数量

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

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE。

支持信息

BatchData API：文档 | 仪表盘
MCP 协议：文档
问题反馈：GitHub 问题

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

batchdata-mcp-real-estate