Real Estate Data MCP Server by BatchData

](https://mseep.ai/app/zellerhaus-batchdata-mcp-real-estate)

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

](https://smithery.ai/server/@zellerhaus/batchdata-mcp-real-estate)

与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服务器克隆或下载到本地计算机

1. 安装依赖项:

   cd batchdata-mcp-real-estate
   npm install

1. 配置API密钥:

- 从获取API密钥 批处理数据设置 或 在这里注册. - 创建或更新 .env 项目根目录中的文件：

   BATCHDATA_API_KEY=your_actual_api_key_here

1. 构建TypeScript项目:

   npm run build

1. 测试服务器:

   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

1. 使用Docker Compose运行：

   ./docker-manage.sh run

1. 查看日志：

   ./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标准限值

环境变量

错误处理

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

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

依赖项

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

贡献

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

许可证

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

支持

• BatchData API: 文档 | 仪表盘
• MCP协议: 文档
• 问题:

](https://lobehub.com/mcp/zellerhaus-batchdata-mcp-real-estate)

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