nycrentals

Name: nycrentals
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 nycrentals

nycrentals 是连接托管 Borough MCP 服务的验证桥接层，可搜索纽约市出租和待售房源，也能查询房产、楼宇详情及社区市场数据并进行比较。

主要功能

01搜索出租房和待售房源
02查询房产与楼宇详情
03浏览行政区和社区
04查看并比较社区市场数据

适用场景

01按价格和条件筛选纽约房源
02看房前了解房源或楼宇信息
03比较不同社区的市场情况

MCP 相关

向 MCP 客户端提供十种房产搜索、详情、区域和市场数据工具，并将通过验证的调用转发至托管 Borough 服务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @reneturcios/nycrentals

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/nycrentals0.1.0stdio

ocighcr.io/cloudcorprecords/nycrentals:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
page	number	否	页码；上游默认值为 1。
sort	enum	否	排序字段。PRICE \| LISTED_AT \| RECOMMENDED
areas	any	否	区域 ID（逗号分隔的字符串或数组，最多 10 个）。行政区 ID：Manhattan=100、Bronx=200、Brooklyn=300、Queens=400、Staten Island=500。
noFee	boolean	否	仅限免中介费的租房。接受 true，或省略此参数。
maxBeds	integer	否	卧室数量上限，0–50。
maxSqft	number	否	最大面积（平方英尺）。
minBeds	integer	否	卧室数量下限，0–50；0 表示单间公寓。
minSqft	number	否	最低面积（平方英尺）。
perPage	number	否	每页结果数；默认值为 3，上游最大值为 5。
sortDir	enum	否	排序方向。ASC \| DESC
location	string	否	单个行政区或社区名称。
maxBaths	integer	否	浴室数量上限，1–4。
maxPrice	number	否	最高价格。
minBaths	integer	否	浴室数量下限，1–4。
minPrice	number	否	最低价格。
amenities	any	否	便利设施枚举值，例如 DISHWASHER、WASHER_DRYER、ELEVATOR、DOORMAN、LAUNDRY、GYM、POOL、PARKING。
fiberOnly	boolean	否	仅限配备光纤互联网的楼宇。
has3dTour	boolean	否	仅限带有 3D 看房的房源。接受 true，或省略此参数。
locations	any	否	行政区或社区名称。
petsAllowed	boolean	否	仅限允许宠物的房源。
buildingType	string	否	逗号分隔：RENTAL、CONDO、CO_OP、CONDOP、HOUSE、SINGLEFAMILY、TOWNHOUSE、TWOFAMILY、THREEFAMILY、FOURFAMILY、MULTI_FAMILY、MIXED_USE、HYBRID、COMMERCIAL、UNKNOWN。
hasOpenHouse	boolean	否	仅限设有开放看房活动的房源。接受 true，或省略此参数。
maxMonthlyCost	number	否	每月总费用上限。
minDownloadMbps	number	否	最低下载速度，单位为 Mbps。
minTransitScore	number	否	交通便利度评分下限，0–100。

详细介绍

nycrentals

纽约市住房搜索，按照这座城市的实际组织方式：按行政区和社区搜索。nycrentals 是连接托管 Borough MCP 服务的轻量验证桥接层，提供十种工具，用于搜索曼哈顿、布鲁克林、皇后区、布朗克斯和史泰登岛的出租房和待售房源、打开搜索结果背后的房源或楼宇，以及在决定看房前了解社区周边的市场情况。

该桥接层负责两项工作：在本地提供工具列表，并在任何调用离开设备前检查每项调用：参数类型、必填字段，以及服务自身的使用规则——只能选择一种地点命名方式（areas、location 或 locations，不可混用）；费用和看房标志只能开启；售房搜索不得带有中介费标志；单次搜索最多包含 10 个区域 ID；比较范围必须在 1 到 5 个社区之间。通过检查的调用会通过一个仅建立一次并重复使用的上游会话转发；服务返回的所有内容——包括带价格、照片和新鲜度标记的房源——都会原样返回。

十种工具：

search_rentals — 搜索五个行政区的在租房源，可按价格、卧室和浴室数量、面积、配套设施、楼宇类型、宠物政策、交通评分和网速筛选，并可开启免中介费、开放日和 3D 看房选项。
search_sales — 搜索在售房源，支持相同的筛选条件，另有售房类型选择器。
get_property — 获取单套房源的完整信息：价格、地址、卧室和浴室数量、配套设施、宠物政策和楼宇评分，采用适合聊天客户端的紧凑格式。
get_property_by_url — 通过房源 URL 路径而非 ID 获取相同的详细信息。
get_building — 获取楼宇档案：类型、建成年份、楼层和单元数、配套设施、政策、管理信息和税收减免状态。
get_building_listings — 获取与某栋楼宇相关的房源，按价格从低到高排列。
list_areas — 获取区域目录：316 个社区和子区域、五个行政区以及北新泽西覆盖范围，支持分页。
get_market_snapshot — 获取某个社区当前的市场统计数据。
get_market_trends — 获取某个社区近期的价格走势，每行对应一个日期和事件类型。
compare_neighborhoods — 并排比较 1 到 5 个社区。

区域 ID 按行政区划分为数百号段：曼哈顿为 100，布朗克斯为 200，布鲁克林为 300，皇后区为 400，史泰登岛为 500；各行政区内的社区另行编号。

配置

从环境中读取一个凭据：

export BOROUGH_API_KEY="..."

每种工具都需要密钥。若未提供，调用会立即失败并返回 BOROUGH_API_KEY is not set，且不会向任何地方发送任何内容。访问级别由托管服务执行，而非此桥接层。

CLI

每种工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/nycrentals search_rentals '{"location":"Brooklyn","maxPrice":3500,"noFee":true}'
npx @reneturcios/nycrentals get_property '{"id":"..."}'
npx @reneturcios/nycrentals compare_neighborhoods '{"locations":["Astoria","Jackson Heights"]}'
npx @reneturcios/nycrentals --version

输出为转发结果的 JSON 内容。退出代码：成功时为 0，发生错误结果时为 1（包括验证失败或上游失败），用法错误时为 2。

MCP 服务

npx -y @reneturcios/nycrentals mcp

MCP 客户端配置：

{
  "mcpServers": {
    "nycrentals": {
      "command": "npx",
      "args": ["-y", "@reneturcios/nycrentals", "mcp"],
      "env": { "BOROUGH_API_KEY": "..." }
    }
  }
}

Docker

docker run -i -e BOROUGH_API_KEY="..." ghcr.io/cloudcorprecords/nycrentals
docker run --rm -e BOROUGH_API_KEY="..." ghcr.io/cloudcorprecords/nycrentals list_areas '{"level":1}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake MCP upstream, no network)
npm run dev     # run the CLI from source