RE Data Refinery MCP 服务器

一个模型上下文协议（MCP）服务器，可将杂乱的不动产数据转化为干净、评分、AI就绪的物业情报，适用于哥伦布市（OH）及周边都市区。

与通用物业API不同，RE Data Refinery 结合了实时Zillow数据与县级丰富数据（GIS、税务拖欠、治安官拍卖、许可证、遗嘱认证记录），并为每个房源计算专有投资评分。代理仅需为其运行的查询付费——无需订阅、无API层级——通过Base主网上的x402微支付协议。

• 实时数据源： ZillAPI

• 覆盖范围： 在哥伦布市14个都市区预置150多个物业

• 支付方式： Base上的USDC，每次付费查询$0.35

• 传输方式： stdio / SSE，支持Claude Desktop、Claude Code、ChatGPT Desktop、Hermes及其他MCP客户端

与众不同之处

工具（10个）

快速开始

1. 安装依赖

pip install "x402>=2.20.0" eth-account httpx

2. 克隆仓库

git clone https://github.com/areshms/re-refinery-mcp.git
cd re-refinery-mcp

3. 配置你的环境

在项目根目录创建.env文件：

# Required for paid Worker lookups
EVM_PRIVATE_KEY=0x...

# Optional
X402_SPEND_CAP=$1                    # max per-payment USD cap (default: $1)
REFINERY_BASE_URL=https://re-data-refinery.ares-hms.workers.dev
REFINERY_LOCAL_URL=http://localhost:5004

你的钱包必须持有 Base上的USDC 才能支付查询。

4. 添加到你的MCP客户端

Claude Desktop / Claude Code：

{
  "mcpServers": {
    "re_refinery_mcp": {
      "command": "python3",
      "args": ["/path/to/re-refinery-mcp/re_refinery_mcp.py"],
      "env": {
        "EVM_PRIVATE_KEY": "${EVM_PRIVATE_KEY}",
        "X402_SPEND_CAP": "$1"
      }
    }
  }
}

本地开发模式

为避免花费USDC进行开发或测试，可禁用x402并指向免费本地API：

export REFINERY_ENABLE_X402=false
export REFINERY_LOCAL_URL=http://localhost:5004
python3 re_refinery_mcp.py --transport stdio

然后付费端点将调用 localhost:5004，而不是Worker。

支付如何运作

1. 你的代理请求一个付费端点。

2. Worker返回 HTTP 402 Payment Required 和x402支付要求。

3. MCP客户端在Base上签署一笔Permit2 USDC交易。

4. CDP促进器验证签名并在链上结算支付。

5. Worker返回请求的数据。

一旦配置了EVM_PRIVATE_KEY，所有这些都会自动处理。

评分方法论

每个物业都经过丰富处理：

• flip_score（0–100）：折扣相对Zestimate的折扣、上市天数、社区中位数、房龄、地块面积

• wholesale_score（0–100）：权益差额、税务拖欠、DOM、业主自住率、价格相对Zestimate

• rental_yield_pct：年租金估算 ÷ 价格

• market_heat：热 / 温 / 冷，基于上市天数和近期价格趋势

评分会与实时精炼缓存中的社区中位数重新计算。

要求

• Python 3.11+

• x402>=2.20.0

• eth-account

• httpx

• 持有Base上USDC的钱包

Worker

支持此服务器的Cloudflare Worker：

https://re-data-refinery.ares-hms.workers.dev

它是第一个使用x402变现网关的房地产数据服务器。

许可证

MIT

由 Hightower Marketing 打造——让房地产数据为AI代理服务。