房地产数据协议服务

Property MCP Server是一个连接Claude AI与房地产数据的模型上下文协议服务器,通过ATTOM Data API实现数据交互。

  • by noahw345
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 noahw345/property-MCP

使用说明

属性MCP服务器

通过ATTOM data API将Claude AI连接到房地产数据的最小模型上下文协议服务器。

快速开始

# Install dependencies
pip install -r requirements.txt

# Set up .env file
echo "ATTOM_API_KEY=your_key_here" > .env

# Test the tool
python test_tool.py "1600 Amphitheatre Parkway, Mountain View, CA 94043"

# Run the server (for Claude Desktop)
python -m mcp_server.server

建筑

mcp_server/
├── server.py            # Entry point
├── tools/
│   └── property_info_tool.py  # tool interface
├── services/
│   └── attom_client.py  # HTTP client
├── config.py            # Environment config
└── utils/
    └── errors.py        # Exceptions

错误处理

错误被捕获并作为结构化JSON响应返回:

{
  "error": True,
  "message": "ATTOM API error: 400 Bad Request",
  "status_code": 400
}
  • API错误:从ATTOM API响应中解析的HTTP错误
  • 网络错误:APIError中包含连接失败
  • 配置错误:缺少API键在启动时引发ConfigError
  • 工具层:捕获APIError并返回错误字典(从不引发)

Claude桌面配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "property-mcp": {
      "command": "/path/to/venv/bin/python3.12",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/path/to/property-MCP",
      "env": {
        "PYTHONPATH": "/path/to/property-MCP"
      }
    }
  }
}

收件人API文件

https://api.developer.attomdata.com/