zellerhaus/batchdata-mcp-real-estate

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

33 stars 9 forks 质量 67 趋势 11MIT

Repository Install

用于 BatchData.io 物业和地址API的模型上下文协议（MCP）服务器——Claude及其他AI助手的房地产数据集成

概览

一个模型上下文协议（MCP）服务器，集成了 BatchData.io 全面的属性和地址 API。该服务器提供访问物业数据、地址验证、跳绳追踪、地理编码及高级物业搜索功能。 - ：利用USPS验证和标准化地址 - ：在您输入时获得智能地址建议 - ：将地址转换为纬度/经度坐标 - ：将坐标转换回可读地址 - ：通过地址或评估者地块号（APN）获取详细物业信息 - ：带全面筛选的高级物业搜索 - ：使用边界框或半径进行地理边界搜索 - ：获取符合特定条件的物业计数（轻量级操作）通过 Smithery 自动安装 Claude Desktop 的 batchdata-mcp-real-estate ： 3. ： - 从 BatchData 设置获取 API 密钥或在此注册。- 创建或更新项目根目录中的 .env 文件： docker-manage。

概述（AI 翻译）

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

特色

地址操作

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

物业运营

查询房产：按地址或评估员地块号（APN）获取详细房产信息
search-properties：带全面筛选的高级房产搜索
按边界搜索属性：使用边界框或半径进行地理边界搜索
count-properties：获取符合特定条件的属性计数（轻量级操作）

安装

通过Smithery安装

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

手动安装

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

BatchData - Real Estate Data - MCP Server

A Model Context Protocol (MCP) server that integrates with BatchData.io’s comprehensive property and address APIs. This server provides access to property data, address verification, skip tracing, geocoding, and advanced property search capabilities.

Features

Address Operations

verify-address: Validate and standardize addresses using USPS verification
autocomplete-address: Get intelligent address suggestions as you type
geocode-address: Convert addresses to latitude/longitude coordinates
reverse-geocode: Convert coordinates back to readable addresses

Property Operations

lookup-property: Get detailed property information by address or APN (Assessor Parcel Number)
search-properties: Advanced property search with comprehensive filters
search-properties-by-boundary: Geographic boundary searches using bounding boxes or radius
count-properties: Get property counts matching specific criteria (lightweight operation)

Installation

Installing via Smithery

To install batchdata-mcp-real-estate for Claude Desktop automatically via Smithery:

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

Manual Installation

Clone or download this MCP server to your local machine

Install dependencies:

cd batchdata-mcp-real-estate
npm install

Configure your API key:
- Get your API key from BatchData Settings or register here.
- Create or update the .env file in the project root:
```
BATCHDATA_API_KEY=your_actual_api_key_here
```
Build the TypeScript project:
```
npm run build
```
Test the server:
```
npm start
```

Quick Setup

Use the automated setup scripts:

Linux/macOS:

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

Windows:

setup.bat

Docker Support

Quick Start with Docker

Build and test the Docker container:

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

Run with Docker Compose:
```
./docker-manage.sh run
```
View logs:
```
./docker-manage.sh logs
```

Docker Management Commands

The docker-manage.sh script provides convenient commands:

build: Build the Docker image
run: Start with docker-compose
stop: Stop the service
logs: View server logs
test: Build and test the server

在 GitHub 查看完整 README

安装

docker exec -i batchdata-mcp-server node batchdata_mcp_server.js

新手？先看 mcpskill.org 教程 →

配置

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