rentfeed

rentfeed

rentfeed 是一个本地小型桥接程序，用于连接托管的 HousingFeed MCP 服务，该服务将美国租房房源发布为结构化 数据。其中两个工具完全无需密钥：示例搜索可按区域和预算 返回最多 10 条实时房源，摘要工具则可报告单个城市或 ZIP 的 房源数量、中位数和百分位挂牌租金。其余三个工具可访问你 从 HousingFeed 获得许可的房源数据： 其当前状态、可搜索的房源视图， 以及最新每周更新中的变更。

该桥接程序不会存储自己的房源。它会在本地提供上游服务的工具 列表，与从实时端点捕获的内容完全一致，并将每次工具调用 转发给上游，原样返回结果。工具中不包含预订、申请、消息或 支付功能；仅提供房源数据。

工具

• search_rentals_sample — 免费搜索美国实时租房 房源示例，可按区域和预算搜索，每次调用最多 10 条。可选参数：state、city、min_rent、 max_rent、min_beds、max_beds、地图范围框 （min_lat、max_lat、min_lng、max_lng）、 new_since_days 和 sort（best、newest、 cheapest、rent_desc）。
• rent_summary — 查询美国单个城市或 ZIP 的租金 统计数据：房源数量，以及挂牌租金的中位数、第 25 和第 75 百分位数，并提供总览和按卧室数量划分的数据。必填参数：state。可选参数：city、zip、 beds（0 = 单间公寓，4 = 四间及以上）和 include_rooms。
• feed_status — 你获得许可的房源 Feed 状态： 房源数量、发布时间、下次每周更新的时间，以及新增、变更和 移除的房源数量。需要 HousingFeed 密钥。
• search_my_feed — 按城市、ZIP、租金、卧室数量或地图范围框 搜索你获得许可的房源 Feed，每次调用最多 50 条，可通过 offset 分页。可选参数：state、city、zip、min_rent、 max_rent、min_beds、max_beds、地图范围框、 limit、offset 和 full。需要密钥。
• feed_changes — 你房源 Feed 最新每周更新中新增、变更或移除的 房源。可选参数：change（added、changed、removed）、since、 limit（默认值为 20）和 offset。需要密钥。

配置

• HOUSINGFEED_MCP_URL（可选）— 覆盖上游端点。默认值为 https://housingfeed.com/mcp。（此覆盖钩子是本次重建 自行标注的还原内容。）
• HOUSINGFEED_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 请求头，其中包含你自己的 HousingFeed 密钥，可解锁你获许可市场的三种 Feed 工具。未设置时， 不会发送密钥请求头，只有无需密钥的工具可以 成功。（请求头名称和 Bearer 格式由原始版本的注册记录确定； 从此环境变量转发密钥是本次重建自行标注的还原内容 — 原始界面是在无密钥状态下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo name rentfeed），然后发送 notifications/initialized 通知，接着发送携带调用方参数原值的 tools/call 请求。上游在 initialize 响应中返回 Mcp-Session-Id 请求头时，该值会附加到此会话的 每个后续请求中，并在进程运行期间复用该会话。响应可能是 普通 JSON，也可能是服务器发送的事件；两种格式都会读取。

上游成功结果会原样传递，包括上游设置的任何 isError 标记。 失败情况 — JSON-RPC 错误、非 2xx 状态、无法读取的响应，或 无法完成的请求 — 会作为 isError 结果返回，文本以 rentfeed error: 开头（此错误呈现方式是本次重建自行标注的还原内容）。

CLI

每个工具也可作为子命令使用，并接受一个 JSON 参数字符串：

npx @reneturcios/rentfeed search_rentals_sample '{"state":"NY","city":"Brooklyn","max_rent":3000}'
npx @reneturcios/rentfeed rent_summary '{"state":"TX","city":"Austin"}'
npx @reneturcios/rentfeed feed_status '{}'
npx @reneturcios/rentfeed --version

退出代码：成功时为 0，结果为 isError 时为 1， 用法错误时为 2。

MCP 服务

npx -y @reneturcios/rentfeed mcp

MCP 客户端配置：

{
  "mcpServers": {
    "rentfeed": {
      "command": "npx",
      "args": ["-y", "@reneturcios/rentfeed", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/rentfeed
docker run --rm ghcr.io/cloudcorprecords/rentfeed --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他任何参数都会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对存根 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。