fangjia_mcp

杭州商品住房一房一价的免费 MCP。数据来自杭州市数据开放平台，由杭州市住保房管局提供。

价格字段是备案总价（元）。数据集没有建筑面积，不能换算成单价，也不是网签成交价。

架构

Agent 只访问本服务的 /mcp。调用前要走 Supabase OAuth：用 Google 或邮箱登录，并在同意页允许访问。没有有效登录令牌时，/mcp 返回 401。浙江政务网关的密钥留在服务端，同步程序把分页结果写入 Supabase，查询不再打政务接口。

全量约 220 万条。首次同步在本机跑，靠 sync_state.next_page 断点续传。部署到 Vercel 之后，每天 UTC 18:00 的 Cron 只补 2 页。

准备

Supabase 由 Vercel Marketplace 接入，环境变量会写进 Production、Preview 和 Development。supabase/migrations 里的新 SQL 在推送到 main 后由 GitHub Actions 自动执行。

本地开发可以执行 npx vercel env pull .env.local --environment development。

杭州接口的 HZ_USER_SECRET 是开放平台个人中心账号设置里的用户名。只有在「成果管理」里创建过应用成果时，才需要额外配置 HZ_APP_SECRET。

命令

npm run dev
npm run check
npm run sync
npm run sync -- --from-start

SYNC_MAX_PAGES 默认 20，SYNC_PAGE_SIZE 默认 100。重复执行 npm run sync，直到状态变成 caught_up。

接入

{
  "mcpServers": {
    "fangjia": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

工具：dataset_status、search_filings、summarize_permit。

上架

部署到 Vercel 后，把 server.json 里的远程地址改成线上 /mcp，再用官方 MCP Registry 的发布工具提交。命名空间 cn.fangjia/housing-filings 需要换成你已认领的发布者名称。