Batchdata MCP Real Estate

🚀 BatchData MCP 服務器

BatchData MCP 服務器是一個集成了 BatchData.io 全面的房產和地址 API 的模型上下文協議（MCP）服務器。該服務器提供房產數據訪問、地址驗證、跳過追蹤、地理編碼以及高級房產搜索等功能。

🚀 快速開始

本 MCP 服務器可讓 Claude 直接通過自然語言查詢訪問全面的房產數據、進行地址驗證和開展高級房產搜索，為房地產專業人士和開發者提供便利。

✨ 主要特性

地址操作

• verify-address：使用美國郵政服務（USPS）驗證來驗證和標準化地址。
• autocomplete-address：在您輸入時提供智能地址建議。
• geocode-address：將地址轉換為經緯度座標。
• reverse-geocode：將座標轉換回可讀的地址。

房產操作

• lookup-property：通過地址或評估包裹編號（APN）獲取詳細的房產信息。
• search-properties：使用綜合過濾器進行高級房產搜索。
• search-properties-by-boundary：使用邊界框或半徑進行地理邊界搜索。
• count-properties：獲取符合特定條件的房產數量（輕量級操作）。

📦 安裝指南

1. 將此 MCP 服務器克隆或下載到本地機器。
2. 安裝依賴項：

   cd batchdata-mcp-real-estate
   npm install
   

3. 配置 API 密鑰：
   • 從 BatchData 設置 獲取 API 密鑰，或者 在此註冊。
   • 在項目根目錄創建或更新 .env 文件：

   BATCHDATA_API_KEY=your_actual_api_key_here
   

4. 構建 TypeScript 項目：

   npm run build
   

5. 測試服務器：

   npm start
   

💻 快速設置

使用自動化設置腳本： Linux/macOS：

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

Windows：

setup.bat

💻 開發命令

• Build：npm run build - 將 TypeScript 編譯為 JavaScript。
• Start：npm start - 運行編譯後的 JavaScript 服務器。
• Dev：npm run dev - 一個命令完成構建和運行。
• Clean：npm run clean - 刪除編譯後的 JavaScript 文件。

💻 針對 Claude Desktop 的配置

要將此 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"
      }
    }
  }
}

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 - 房產數量查詢。

💻 使用示例

統計鳳凰城的房產數量

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 每個端點的速率限制如下：

• 地址驗證：最大 5,000 次（建議每批次 1,000 次）。
• 地址地理編碼：最大 90 次（建議每批次 75 次）。
• 房產搜索：最大請求數為 1,000 次。
• 房產查詢：遵循標準 API 限制。

環境變量

錯誤處理

服務器包含全面的錯誤處理機制，可處理以下情況：

• 無效的 API 密鑰。
• 網絡請求失敗。
• 格式錯誤的請求。
• API 速率限制超出。
• 無效的參數組合。

依賴項

• @modelcontextprotocol/sdk：核心 MCP 框架。
• zod：運行時類型驗證。
• dotenv：環境變量加載。
• typescript：TypeScript 編譯器。
• @types/node：Node.js 類型定義。

📄 許可證

本項目採用 MIT 許可證，詳情請見 LICENSE。

📚 支持

• BatchData API：文檔 | 儀表盤
• MCP 協議：文檔
• 問題反饋：GitHub 問題

房地產專業人士和開發者：此 MCP 服務器使 Claude 能夠直接通過自然語言查詢訪問全面的房產數據、進行地址驗證和開展高級房產搜索。

🔗 貢獻指南

有關開發設置和指南，請參閱 CONTRIBUTING.md。