mcpField
B
booli-mcp

booli-mcp

本地服务
github.com/chrischall商业与营销43 天前更新
代码仓库

关于 booli-mcp

booli-mcp 是用于查询瑞典 Booli 房源和市场数据的 MCP 服务，面向需要检索房源及成交信息的用户。它提供只读工具，并可在直连受阻时通过 ContextMint Bridge 使用已登录的 Booli 浏览器会话。

主要功能

  1. 01搜索在售房源
  2. 02查询已售房源及成交价
  3. 03将地点名称解析为区域 ID
  4. 04获取房源详情和市场统计
  5. 05检查数据连接与桥接状态

适用场景

  1. 01查找指定区域的在售住房
  2. 02比较成交价和区域市场统计
  3. 03检索某套房产的详细信息

MCP 相关

向 MCP 客户端提供区域、房源、成交价、房产详情、市场统计和健康检查工具。查询可直接访问，也可通过 ContextMint Bridge 和已登录的 Booli 浏览器标签页发送。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "chrischall-booli": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/booli-mcp"
      ],
      "env": {
        "BOOLI_TRANSPORT": "<BOOLI_TRANSPORT>",
        "BOOLI_WS_PORT": "<BOOLI_WS_PORT>",
        "FETCHPROXY_WS_HOST": "<FETCHPROXY_WS_HOST>",
        "FETCHPROXY_IDENTITY_DIR": "<FETCHPROXY_IDENTITY_DIR>"
      }
    }
  }
}
启动命令npx -y @chrischall/booli-mcp
需要配置的环境变量
BOOLI_TRANSPORTSelects the path: auto (default — direct fetch first, browser-bridge fallback when walled), fetchproxy (always the bridge), or direct.
BOOLI_WS_PORTOverride the fetchproxy WebSocket port (the fleet shares 37149).
FETCHPROXY_WS_HOSTBridge bind interface, a literal IP only (default 127.0.0.1). Keep on loopback; exists for a hosted child in its own network namespace.
FETCHPROXY_IDENTITY_DIRAbsolute path for the long-term bridge identity keypair (default ~/.fetchproxy/identity/). Exists for a host that runs a separate child per caller.

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

安装包
npm@chrischall/booli-mcp2.1.11

工具

6

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

参数类型必填说明
limitinteger否最大结果数（默认值为 10）。
querystring是地名搜索字符串（例如 "Nacka"、"Södermalm"）。

详细介绍

booli-mcp

一个面向 Booli 的 MCP 服务。Booli 是瑞典的房产门户网站，可用于搜索在售房源、已售价格（slutpriser）、解析区域并计算市场统计数据，所有操作均可通过 Claude 完成。

由 AI（Claude Code）开发和维护。请自行斟酌使用，并遵守 booli.se 的使用条款。

工作原理

Booli 通过 Cloudflare 反爬虫防护墙代理 www.booli.se（包括其 GraphQL API），阻止服务端客户端访问。因此，booli-mcp 会通过 fetchproxy 桥接（ContextMint Bridge 浏览器扩展），将每个查询路由到你已登录的 www.booli.se 浏览器标签页，重复使用已通过 Cloudflare 验证的会话，从而读取 Booli 的消费者 GraphQL API。无需登录 Booli，只需正常浏览页面即可。所有工具均为只读。

BOOLI_TRANSPORT 用于选择路径：auto（默认——优先直接请求，受阻时回退到浏览器桥接）、fetchproxy（始终使用桥接）或 direct。fetchproxy 集群共享 WS 端口 37149（BOOLI_WS_PORT）。

设置

  1. 从其发布页面安装 ContextMint Bridge——Chrome：下载 Chrome 压缩包，解压后在 chrome://extensions 中以未打包扩展的方式加载（开发者模式）。Safari 版本尚不可用（它将随 ContextMint 应用一起发布，该应用目前没有公开下载渠道），因此暂时请使用 Chrome。保持一个 www.booli.se 标签页处于打开状态。

    ContextMint Bridge 是 fetchproxy 浏览器扩展的新名称，由同一位维护者开发——fetchproxy 自身的 README 中也指向了它。其源代码公开在 nullnet-app/contextmint-bridge：你可以自行构建，也可以使用旁边发布的 .sha256 文件校验发布压缩包（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

  2. 首次请求时，在 ContextMint Bridge 中批准一次性配对提示。

  3. 运行 booli_healthcheck 确认路径可用。其 transport 字段会显示探测请求使用的通道（direct 或 fetchproxy）；桥接建立后，bridge.session_state 会显示扩展状态：linked、pair_pending（批准其中所示的配对码）或 extension_disconnected。

安装

// mcp config
{
  "mcpServers": {
    "booli": {
      "command": "npx",
      "args": ["-y", "@chrischall/booli-mcp"]
    }
  }
}

工具

工具功能
booli_search_areas将地点名称解析为 Booli 区域 ID
booli_search_listings按区域和筛选条件搜索在售房源
booli_get_listing根据房屋 ID 获取一套房产的完整详情（在售或已售）
booli_search_sold搜索已售房源（slutpriser）及最终价格
booli_market_stats获取某区域已售价格的中位数/平均值统计数据
booli_healthcheck探测数据路径并报告 transport（direct / fetchproxy，即 BOOLI_TRANSPORT 模式）；桥接运行后，还会报告 bridge（角色、端口、扩展连接状态 session_state、待处理的配对码）及后续操作提示

搜索范围可通过 area_id（来自 booli_search_areas）或自由文本 location 指定。金额单位为 SEK，面积单位为 m²。底层 GraphQL API 详见 docs/BOOLI-API.md。

开发

npm install
npm test          # vitest, no network
npm run build     # tsc + esbuild bundle

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。