批处理数据-MCP-房地产

Name: 批处理数据-MCP-房地产
Author: zellerhaus

作者：zellerhaus21 星标更新：2025-07-21

安装使用来源：spider==github.com

项目介绍

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

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

功能

地址操作

verify-address: 使用 USPS 验证并标准化地址
autocomplete-address: 在输入时获取智能地址建议
geocode-address: 将地址转换为经纬度坐标
reverse-geocode: 将坐标转换回可读地址

房产操作

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

安装

通过 Smithery 安装

要通过 Smithery 自动安装 batchdata-mcp-real-estate 到 Claude Desktop：

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

手动安装

将此 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
```

快速设置

使用自动设置脚本：

Linux/macOS:

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

Windows:

setup.bat

Docker 支持

使用 Docker 快速启动

构建并测试 Docker 容器：

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

使用 Docker Compose 运行：
```
./docker-manage.sh run
```
查看日志：
```
./docker-manage.sh logs
```

Docker 管理命令

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

build: 构建 Docker 镜像
run: 使用 docker-compose 启动
stop: 停止服务
logs: 查看服务器日志
test: 构建并测试服务器
clean: 清理 Docker 资源
run-direct: 直接使用 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 用户以增强安全性
健康检查用于监控
资源限制和日志配置
生产就绪，具有适当的信号处理

开发命令

Build: npm run build - 编译 TypeScript 到 JavaScript
Start: npm start - 运行编译后的 JavaScript 服务器
Dev: npm run dev - 一次命令构建并运行
Clean: 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"
      }
    }
  }
}

Docker 配置用于 Claude Desktop

如果通过 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 - 房产计数查询

示例用法

计算凤凰城的房产数量

我需要计算亚利桑那州凤凰城之间价值在 250,000 美元至 600,000 美元之间的独栋住宅数量

查找相似房产

查找位于亚利桑那州凤凰城 2800 N 24th St, 85008 附近一英里内的相似房产

验证地址

验证这个地址：2800 N 24th St, Phoenix, Arizona 85008

API 速率限制

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

地址验证: 最大 5,000 次（推荐每批 1,000 次）
地址地理编码: 最大 90 次（推荐每批 75 次）
房产搜索: 最大请求次数 1,000 次
房产查找: 标准 API 限制

环境变量

变量	描述	是否必需
`BATCHDATA_API_KEY`	您的 BatchData.io API 密钥	是

错误处理

服务器包括全面的错误处理：

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

依赖项

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

贡献

参见 CONTRIBUTING.md 了解开发设置和指南。

许可证

MIT 许可证 - 详情见 LICENSE。

支持

BatchData API: 文档 | 仪表板
MCP 协议: 文档
问题: GitHub 问题

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