关于 stream-estate
stream-estate 是连接 Stream.estate 法国房地产 API 的已弃用 MCP 服务,计划于 2026 年 12 月 31 日停止工作。它支持房源搜索、市场指标、保存搜索和 Webhook 操作。
主要功能
- 01使用丰富筛选条件搜索房源
- 02获取房源详情和相似房源
- 03查询城市及附近兴趣点
- 04查看每平方米价格统计
- 05管理保存的搜索和 Webhook
适用场景
- 01按地点、价格或面积查找法国房源
- 02比较不同地点和时间的房价
- 03保存搜索并接收 Webhook 通知
MCP 相关
将 Stream.estate API 功能作为 MCP 工具提供,涵盖房源搜索、市场数据、保存的搜索和 Webhook 测试。此 v1 服务已弃用;README 指向 v2 远程 MCP 服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
13收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 按城市名称筛选 |
| page | number | 否 | |
| slug | string | 否 | |
| label | string | 否 | 按显示名称筛选 |
| polygon | string | 否 | GPS 坐标多边形 |
| zipcode | string | 否 | |
| zipcodes | array | 否 | |
| inseeCode | string | 否 | 按单个 INSEE 代码筛选 |
| inseeCodes | array | 否 | 按多个 INSEE 代码筛选 |
| sortByName | enum | 否 | asc | desc |
| excludeGroupedCities | boolean | 否 |
详细介绍
Stream Estate MCP 服务(v1,已弃用)
警告
此服务已弃用,将于 2026 年 12 月 31 日停止工作,Stream Estate API v1 也将同时停止服务。 请切换到 v2 远程 MCP 服务:
https://api-v2.stream.estate/mcp(HTTP 传输,X-API-KEY标头),该服务已列入 MCP Registry,名称为estate.stream/mcp。 设置指南:https://next.docs.stream.estate/en/docs/guides/mcpclaude mcp add --transport http streamestate https://api-v2.stream.estate/mcp --header "X-API-KEY: <your_key>"
适用于 Stream.estate 法国房地产 API 的 MCP 服务。搜索房产、获取市场统计数据、通过 webhook 通知管理已保存的搜索等。
前置条件
- Node.js >= 20
- Stream.estate API 密钥
快速开始
Claude Code(一条命令)
claude mcp add -e STREAM_ESTATE_API_KEY=your-api-key stream-estate -- npx mcp-stream-estate
Claude Desktop
添加到 claude_desktop_config.json:
{
"mcpServers": {
"stream-estate": {
"command": "npx",
"args": ["mcp-stream-estate"],
"env": {
"STREAM_ESTATE_API_KEY": "your-api-key"
}
}
}
}
配置
| 环境变量 | 必需 | 默认值 | 说明 |
|---|---|---|---|
STREAM_ESTATE_API_KEY | 是 | — | 您的 Stream.estate API 密钥(注册) |
STREAM_ESTATE_BASE_URL | 否 | https://api.stream.estate | API 基础 URL |
可用工具
房产
| 工具 | 说明 |
|---|---|
search-properties | 使用 50 多种筛选条件搜索房产(位置、价格、面积、能源等) |
get-property | 根据 UUID 获取完整房产详情 |
find-similar-properties | 查找与指定房产相似的房产 |
指标
| 工具 | 说明 |
|---|---|
get-cities | 按名称、邮政编码或 INSEE 代码搜索城市 |
location-autocomplete | 自动补全城市/省份名称(返回用于筛选的 ID) |
get-points-of-interest | 查找附近的学校、医院、餐厅等 |
get-price-per-meter | 获取价格/平方米统计数据,包括平均值、中位数和时间序列 |
已保存的搜索
| 工具 | 说明 |
|---|---|
create-search | 创建带 webhook 通知的已保存搜索 |
list-searches | 列出所有已保存的搜索 |
get-search | 获取指定的已保存搜索 |
update-search | 更新已保存搜索的条件 |
delete-search | 删除已保存的搜索 |
Webhook
| 工具 | 说明 |
|---|---|
test-webhook | 向 webhook 端点发送测试负载 |
核心概念
- 房产类型:0=公寓,1=独栋住宅,2=建筑物,3=停车位,4=办公室,5=土地,6=商铺
- 交易类型:0=出售,1=出租
- 发布者类型:0=个人,1=专业人士
- 能源等级:A(效率最高)至 G(效率最低)
- 先使用
location-autocomplete查找搜索筛选条件所需的城市/省份 ID
开发
pnpm run dev # Watch mode
pnpm run build # Production build
pnpm start # Run server
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。