BatchData MCP Server

BatchData - 不動産データ - MCP サーバー

BatchData.io の包括的な不動産および住所 API と連携する Model Context Protocol（MCP）サーバーです。このサーバーでは、不動産データ、住所確認、スキップトレーシング、ジオコーディング、高度な不動産検索機能を利用できます。

機能

住所操作

• verify-address：USPS の確認を使用して住所を検証し、標準化します
• autocomplete-address：入力中にインテリジェントな住所候補を取得します
• geocode-address：住所を緯度／経度の座標に変換します
• reverse-geocode：座標を読みやすい住所に変換します

不動産操作

• lookup-property：住所または APN（Assessor Parcel Number）を使って不動産の詳細情報を取得します
• 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

手動インストール

1. この MCP サーバーをローカルマシンにクローンまたはダウンロードします

2. 依存関係をインストールします：

   cd batchdata-mcp-real-estate
   npm install
   

3. API キーを設定します：

   • API キーは BatchData Settings から取得するか、こちらから登録してください。
   • プロジェクトのルートにある .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

Docker のサポート

Docker ですぐに始める

1. Docker コンテナをビルドしてテストします：

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

2. Docker Compose で実行します：

   ./docker-manage.sh run
   

3. ログを表示します：

   ./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 ユーザー
• 監視用のヘルスチェック
• リソース制限とログ設定
• 適切なシグナル処理を備えた本番環境対応

開発コマンド

• ビルド：npm run build - TypeScript を JavaScript にコンパイルします
• 起動：npm start - コンパイル済みの JavaScript サーバーを実行します
• 開発：npm run dev - 1 つのコマンドでビルドして実行します
• クリーン：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"
      }
    }
  }
}

Claude Desktop の 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のエンドポイントごとのレート制限：

• 住所確認：最大5,000件（1回のバッチにつき1,000件を推奨）
• 住所ジオコーディング：最大90件（1回のバッチにつき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 - 詳細についてはLICENSEを参照してください。

サポート

• BatchData API：ドキュメント | ダッシュボード
• MCP Protocol：ドキュメント
• 問題：GitHub Issues

不動産の専門家および開発者向け：このMCPサーバーを使うと、Claudeは自然言語での問い合わせを通じて、不動産の包括的なデータへのアクセス、住所確認、高度な不動産検索を直接行えます。