🚀 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。
支持信息
房地产专业人士和开发者：此 MCP 服务器使 Claude 能够直接通过自然语言查询访问全面的房产数据、执行地址验证和进行高级房产搜索。