mcpField
B
booli-mcp

booli-mcp

ローカル
github.com/chrischallビジネス・マーケティング43 日前に更新

booli-mcp について

booli-mcpは、スウェーデンの不動産ポータルBooliの物件情報や市場データを検索するMCPサーバーです。読み取り専用のツールを提供し、直接接続が阻まれた場合はContextMint Bridge経由でログイン済みブラウザーセッションを利用します。

主な機能

  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 サーバーです。Claude から販売中の物件、成約価格(slutpriser)、地域の特定、市場統計の計算を行えます。

AI(Claude Code)によって開発・保守されています。ご自身の判断のもと、booli.se の利用規約に従ってご利用ください。

仕組み

Booli は www.booli.se と GraphQL API を Cloudflare のボット対策で保護しており、サーバー側のクライアントをブロックします。そのため 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 zip をダウンロードして解凍し、chrome://extensions で展開した拡張機能を読み込みます(デベロッパーモード)。Safari 版はまだ提供されていません(一般公開されていない ContextMint アプリ内で提供予定です)。当面は Chrome をご利用ください。 www.booli.se のタブを開いたままにしてください。

    ContextMint Bridge は、同じメンテナーによる fetchproxy ブラウザー拡張機能の新名称です。fetchproxy の README からも案内されています。 ソースコードは公開されているため、 nullnet-app/contextmint-bridge から自分でビルドするか、リリース zip と同じ場所に公開されている .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 を指定して、1 件の物件の詳細(販売中または成約済み)を取得します
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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。