paris-compass-mcp について
paris-compass-mcpは、パリの商業物件を調べる読み取り専用のMCPサーバーで、賃貸契約を検討する起業家などを対象としています。6つのツールが公開情報に基づく住所や街区の状況を、出典と確信度ラベル付きで返し、単一の不透明なスコアにはまとめません。
主な機能
- 01物件調査用の読み取り専用ツール6種
- 02住所履歴と営業権譲渡記録
- 03街路の入れ替わりと営業継続状況
- 04周辺施設と環境指標
- 05数値ごとの出典・日付・確信度
活用シーン
- 01賃貸契約前にパリの店舗候補を評価
- 02住所で過去の営業業種を確認
- 03周辺施設や環境状況を比較
MCP 対応
ホストされたデータセット上の匿名・読み取り専用ツール6種をMCPクライアントに公開します。`npx -y paris-compass-mcp`で起動できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y paris-compass-mcpSUPABASE_URLOptional. The server carries the public Compass project, so nothing is required to run it. Set this only to read a different Supabase project — a derived deployment.SUPABASE_ANON_KEYシークレットOptional, and never a service key. The anonymous publishable key, read-only under row level security — the same trust boundary a visitor of the website has.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
6掲載時のツール一覧 · 2 週間前に更新
このツールにパラメーターはありません。
詳細
Compass
賃貸契約を結ぶ前に、その通りを調べましょう。
この住所で何が営業していたのか、通りの入れ替わりはどうか、営業権はいくらで売れたのか。公開情報のみを使用し、すべての数値に出典を明記します。
デモを開く → · アカウント不要 · 事前登録済みの住所、17区
エージェント向け → npx -y paris-compass-mcp · 6つのツール、読み取り専用、ホスト済みコーパスを利用
確認したいこと
空き店舗の前に立っています。エージェントは、この通りは活気があると言います。
Compass は6つの軸を一度に回答します。
| ここに何があったか | 10 rue Mandar, 2e:2023年の国勢調査ではアジア料理店で、2017年以降、この番地で営業権の売買が6件ありました |
| 通りの様子 | 業種別の入れ替わりと存続状況を、3回の国勢調査に基づいて測定します。2017年と2020年のライセンスがクリアされるまで公開しません |
| 費用 | fonds の中央値は16万〜17万ユーロ、カフェは22万ユーロです |
| 現在何が動いているか | この場所での倒産手続きは、物件情報が掲載される何か月も前に公開されます |
| 周辺に何があるか | 学校、医療機関、食料品店、公園、交通機関を800 m以内で数え、歩きやすさとして集計します |
| 環境の価値 | 空気質は実測値(Copernicus)、自然災害と技術的リスクは1 km以内、騒音は主要道路から500 mの範囲をモデル化しています |
それぞれの情報には、出典、日付、信頼度が付いています。
表現にもご注目ください。製品内でも同じ表現を使っています。空気質は実測値、騒音はモデル値です。騒音と人通りは代理指標であり、画面上とここでその旨を明記しています。
一文以上を割く価値のある3つ
ここに以前、厨房はありましたか? この区画にレストランが入っていたなら、排気設備、グリストラップ、電源はすでに整っている可能性が高いです。そうでなければ、設置に数万ユーロかかり、建物の合意も必要になります。現地へ行く前に、このデータが答える最も費用のかかる疑問です。
ここは寂れた場所ですか、それとも良い通りですか? 入れ替わりの多い通りは、衰退している通りとは限りません。店舗が入れ替わり、また新たな店舗が入ることもあります。そして、入れ替わりは、その業種自体と、その地域自体に照らして初めて意味を持ちます。同じ業種でも、地区が違えば状況は同じではありません。Compass は3回の国勢調査にわたって、その両方を測定します。
これらの数値はここには掲載していません。 ライセンスがまだ確認されていない2017年版と2020年版に基づいており、サーバーは匿名の呼び出し元には公開しません。このページも製品と同じルールに従います。非公開の版から導かれた率も非公開です。
実際にいくらで取引されたのでしょうか? 2015年以降、価格とともに公開された営業権の売買記録は25 661件です。単一の店舗に結び付けられた5 971件について、パリの fonds の中央値は**160 000〜170 000 €**です。これは一点の値ではなく範囲です。営業権の価格はきりの良い数字で申告されるため、中央値は段階的な値となり、飛び飛びに変化します。そのため、単一の数値では、情報源が示していない精度を装うことになります。ほとんどすべてを決めるのは業種です。
| 食料品店 | カフェ/レストラン | 衣料品 | パーソナルサービス |
|---|---|---|---|
| 250 000 € | 220 000 € | 86 000 € | 50 000 € |
ひとつの住所がそのことを示しています。10 rue Mandar では、trace_premise は2017年から2024年までの営業権の売買を6件返し、価格は87 500〜450 000 €です。2026年10月7日に取得したデータです。どの記録も probable であり、established ではありません。同じ番地を2つの店舗が共有しており、売却されたのがどちらかは公示情報に記載されていないためです。2017年と2020年の国勢調査の行は withheld、2023年の行は established として返されます。
数値が掲載に値するまで
すべての数値には、出典、ライセンス、日付、そして確かさが付いています。
flowchart LR
A["APUR BDCom<br/>3 censuses"] --> M["Address<br/>matching"]
B["BODACC<br/>sales + insolvencies"] --> M
C["INSEE Sirene<br/>establishments"] --> M
M --> V{"Does the source<br/>name THIS unit?"}
V -->|"names it directly"| E["established"]
V -->|"two sources agree,<br/>neither names it"| F["corroborated"]
V -->|"address shared by<br/>several shopfronts"| G["probable"]
V -->|"source is silent"| H["undetermined"]
E --> O["Every figure carries<br/>source · licence · vintage · method"]
F --> O
G --> O
H --> O
O --> UI["Map and unit file"]
O --> MCP["MCP server,<br/>for an agent"]
4段階で示し、パーセンテージは使いません。 100点満点の信頼度スコアは、この製品が拒む、まさに検証不可能な数値です。レベルは既存の列から算出され、各行にはその理由が記載されます。
コーパス全体における構成比。2026年10月6日測定。この品質指標を改善するには、次の4つの数値を左へ動かします。
| 確認済み | 相互確認済み | 可能性が高い | 未確定 |
|---|---|---|---|
| 51.2% | 5.9% | 37.0% | 5.9% |
この37.0%は怠慢ではなく、構造上の問題です。BODACC は「住所」を、BDCom は「区画」を示しますが、区画の69%は同じ番地を共有しています。8つの店舗のうちどれが売却されたかを示す公開データはありません。
リリース前には、全コーパスに対して56件の不変条件、24件の固定ベースライン、8件の手作業で検証した時系列をゲートで実行し、さらに毎日、スケジュールに従って再実行します。不変条件の数は2026年10月6日に grep -c '^-- @invariant ' eval/invariants.sql で確認しました。ほとんどは関数が返す値を検査します。ひとつは関数の性質を検査します。observed 列を公開する関数は SECURITY DEFINER でなければなりません。そうでないと、行レベルセキュリティによって非公開の行が「調査なし」に見えてしまうためです。
上のバッジは不変条件の数を示しており、ゲートの合格を意味するものではありません。現在未解決の赤信号は、porte-rouge のラベルが付いた課題です。
2つの基本方針
ほとんどの商業不動産ツールは、ユニットの情報――床面積、賃料、写真――を示すだけで、残りは利用者の判断に委ねます。Compassが販売するのは、網羅性でも詳細さでもありません。販売するのは解釈であり、コンテキストこそがプロダクトです。
解釈の価値は、どこまで検証できるかで決まります。この市場のツールが約束するのは、監査済みデータに基づく回答です――これは、誰が検証したかを示します。Compassが約束するのは、引用された公開情報源から再導出できる数値です――これは、誰が検証できるかを示します。あなたです。内部監査は約束にすぎません。引用された情報源なら、Compassに対しても、誰もが同じ手順で再検証できます。
引用された公開情報源から再導出できない数値は、表示しません。
家主の申告も、スクレイピングした掲載情報も、独自の推定値も、欠落を埋めるために作ったスコアも使いません。データがない場合は、欠落として表示します――n/a とし、決して 0 にはしません。
同じ通りにある2つのユニットが同じ評価になるなら、Compassは何も伝えていません。
有用な細かさの単位は通りの区間であり、場合によっては歩道の片側です。その規模で変化しない指標は、一般的なコンテキストを示すものであり、意思決定の決め手にはなりません。
対象ユーザー
起業家――店主、レストラン経営者、職人、フランチャイズ加盟者など、どこに出店するかを決める人です。働く人生のうち一度か二度、何年にもわたって拘束される賃貸契約を結びます。
エージェント――MCP サーバーを通じて同じ質問をするLLMです。同じスコアリングの中核、同じ追跡可能性の要件で、出力は異なります。地図ではなく、JSONと推論の連鎖です。
ブローカーではありません。 ブローカーは毎月、何十もの立地を評価し、ポートフォリオ、一括比較、全国的な網羅性を必要とします。そのどれもが、単一の住所を詳しく調べる人にとって、プロダクトを複雑にします。両方に対応しようとすれば、どちらにも応えられません――Compassを求めるブローカーが利用できるのは、エージェントと同じもの、つまりAPIです。
拒むこと
拒むたびに、何かを取り戻せます。その取引こそが要点です。
| 拒むもの | それによって得られるもの |
|---|---|
| 物件掲載ポータル | 掲載よりも 上流 に位置できます。Compass が示すのは、取引停止、営業権の売却、裁判所による清算、調査で判明した空き物件など、空きが出る物件です。誰もがすでに見ている情報ではありません |
| 賃料の推定値 | 誰もが知りたがるあの数字について、誠実でいられます。フランスには、実際の商業賃料をまとめたオープンデータセットがありません |
| 収益予測 | 信頼性です。収益予測をでっち上げれば、ページ上のほかの数字まで信用を損ないます |
| 100 点満点の単一スコア | パン屋が求めるのは人通り、ヨガスタジオが求めるのは静けさ、ワイン専門店が求めるのは所得の中央値です。単一のスコアでは、互いに反する要素が平均化されてしまいます |
| 全国を網羅すること | 深さです。価値ある情報をもたらす情報源は地域にあります |
| 探索するためのアカウント | このツールが役に立つかどうかを確かめる前に、何かを乗り越える必要はありません |
答えられないことと、その理由 — その空白が、機能以上にプロダクトの形を決めます
賃料はいくらになりますか? フランスには、商業賃料を調査するオープンな機関がありません。地域の賃料調査機関が扱うのは民間の 住宅 です。INSEE の ILC は改定指数であり、賃料水準ではありません。街区単位の商業物件の価値は民間事業者が販売しています。それこそが、オープンではない証拠です。営業権の売却価格から間接的なシグナルは得られますが、それ以上のものではありません。
このドアの前を何人が通りますか? パリには恒常的な歩行者センサーがありません。市の複合交通カウンターが計測するのは、自転車、スクーター、オートバイ、自動車、トラック、バスであり、歩行者ではありません。
事業者はこの数字を販売しています。「独自データで高価だ」というだけでは弱い反論です。実態を正確に把握することが大切です。この数字は モバイル端末のパネル に基づいています。サードパーティーアプリに組み込まれた SDK が、バックグラウンドで GPS 座標を報告し、そのサンプルを既知の人口統計に照らして重み付けし、全体へ外挿します。事業者自身もそう説明しています。「全員を見ているわけではありません。サンプルを見ているのです。」 類似のパネルを対象とした査読付き研究では、平均サンプリング率は 7.5% と測定され、4.5% から 14.5% の間で変動していました。また、低所得層や低学歴層の割合が実態より低く、都市部と農村部の偏りは系列の途中で方向が反転していました。1
つまり、この数値は modelled であり、measured ではありません。購入者は自分の通りのパネル規模を確認できず、重み付けを再現できず、再調整によって昨年の数値が変わっても知らされません。問題は誠実さではなく、検証可能性 です。Compass は代わりに、オープンソースから 人の滞在状況とそのリズム を測定し、画面上で代理指標として明示します。
1 Li Z., Ning H., Jing F., Lessani M. N. (2024). Understanding the bias of mobile location data across spatial scales and over time. PLOS ONE 19(1):e0294430.
ここにいる人は何にいくら使っていますか? カード決済データは独自データです。代替手段はありません。
現在、市場に出ている物件はどれですか? 商業物件の掲載情報は、利用規約で再利用が禁止されている民間ポータルにあります。そのため Compass は、そこより上流で機能します。
状況
「構築済み」とは、コードが動作し、ゲートに合格していることを意味し、デプロイ済みという意味ではありません。正確なラベルを付けています。
| コンポーネント | 状態 |
|---|---|
| 地図、近隣スコアリング、環境パネル | デモ — 17区の事前録音された住所を使用しており、まだ取り込んだコーパスには接続されていません |
| すべての数値に出典情報を表示 | 構築済み |
| BDCom ×3 · BODACC · Sirene · 地理情報 | 構築済み — 85 418件の事業所、228 275件の国勢調査記録 |
| ホスト型データベースへのデプロイ | 2026年8月15日から稼働中 — 公開可能なキーを使用して匿名で読み取り可能 |
| ブラウザーでの事業所履歴 — BDCom ×3とBODACCを1つのタイムラインに表示 | 構築済み — デモではなく、開発用ブラウザーからホスト型データベースに対して実演済みです。docs/tickets/w0-fiche.md |
| 1住所のエクスポート可能なファイル | 設計段階、次に着手 |
| エージェント向けMCPサーバー | 公開・登録済み — npx -y paris-compass-mcp (npm、MCP registry)、6つのツール、匿名読み取り専用、設定不要。 |
| エージェント自身の信頼度の自己評価 | 調査中 |
すべての数値の出典
現在接続済み
| 出典 | 提供元 | 用途 | ライセンス |
|---|---|---|---|
| OpenStreetMap(Overpass) | OSM contributors | 空き店舗と営業中の店舗、小売店、学校、医療施設、公園、交通機関、道路 | ODbL |
| Base Adresse Nationale | Etalab / IGN | ジオコーディング | Licence Ouverte 2.0 |
| Rent control dataset | Ville de Paris / OLAP | 住宅のみ — 商圏を示す指標です。商業賃料として提示することはなく、床面積を掛けることも、フィルターとして使うこともありません | ODbL |
| CAMS Europe(Open-Meteo) | Copernicus | AQI、PM2.5、NO₂ | CC BY 4.0 |
| Géorisques | BRGM / MTE | 1 km 圏内の自然災害リスクと技術的リスク | Licence Ouverte 2.0 |
クライアント側で算出するスコア:歩きやすさ、交通アクセス、カテゴリー別密度、騒音、歩行者数。信頼できるオープンソースがないため、後者の2つは推定値であることを明示しています。
ホストデータベースに取り込み済み、デモには未反映
| 出典 | 提供元 | 内容 |
|---|---|---|
| BDCom 2017 / 2020 / 2023 | APUR | ショーウィンドウのあるすべての地上階区画を対象とする戸別調査です。224種類の業種分類と床面積区分を収録しています。区画識別子は各調査年を通じて共通のため、3回分の調査から、過去の営業状況を根拠として、その通りを基準にした入れ替わりを測定できます。主張には2つの制約があります。空き区画を測定できるのは2017年と2020年のみです。2023年のレイヤーには小売店のみが収録されているため、区画が見当たらない場合は「空き」ではなく「もはや店舗ではない」ことを意味します。また、ライセンスは調査年ごとに異なるため、BDCom全体を一律にODbLと案内することはできません |
| BODACC | DILA | 営業権の売却とその価格、倒産手続きです。起業家が支払う金額に最も近い公的な数値であり、区画が空く兆候でもあります |
| 地理情報付き Sirene | INSEE | 裏付け情報です。同じ企業の事業所がその住所にあることを示し、通知を裏付けありに引き上げますが、確定とすることはありません |
PLUの商業保護区域(plub_protcom) | Ville de Paris | 保護対象の沿道では、地上階区画の用途を変更できません。これはプロジェクトを頓挫させる可能性がある、最初に確認すべき事項です。情報提供のみで、規制上の効力はありません。正式な情報源はPortail des Règles d'Urbanismeです。2024年11月20日にConseil de Parisで可決されたバージョンです |
予定
| 出典 | 提供元 | 内容 |
|---|---|---|
| Mobiliscope | CNRS | 実際に滞在している人口を時間ごとに把握します。正午に人口が3倍になるオフィス街と、住宅街を区別できます |
| 交通機関の乗車実績 | Île-de-France Mobilités | 2015年以降の駅別・時間別の乗車人数です。歩行者数の代理指標を実測値に置き換えます |
| DVF | DGFiP | 建物の1 m²あたりの売却価格 |
| INSEE IRIS / FiLoSoFi | INSEE | 人口、所得、社会職業カテゴリー |
| GTFS IDFM | Île-de-France Mobilités | 実際の所要時間と運行頻度 |
| Bruitparif | Bruitparif | モデル値と実測値による騒音データです。道路を代理指標とする方法に置き換えます |
| Sitadel | SDES | 建築許可情報です。2年先の将来の住民と競合を把握できます |
対象範囲
まずはパリ市内、次にイル=ド=フランス地域圏です。広さより深さを重視します。価値を支えるデータソースは地域に根ざしたものです。
スタック
React 18 · TypeScript · Vite 5 · Tailwind + shadcn/ui · Leaflet(ラッパーを使わず直接使用) · TanStack Query · Supabase + PostGIS
src/core/ は純粋なコードで、fetch、React、DOM を使いません。これにより、同じスコアリングをブラウザー、テストランナー、MCP サーバーで利用できます。
ローカルで実行する
Node.js 18 以降。
git clone https://github.com/IvandeMurard/paris-compass.git
cd paris-compass
npm install
npm run dev
http://localhost:8080 で提供されます。
| スクリプト | 内容 |
|---|---|
npm run dev | HMR 対応の Vite 開発サーバー |
npm run typecheck | tsc --noEmit |
npm run test | Vitest |
npm run eval | ゲート:不変条件、ベースライン、ゴールデンケース |
npm run build | 本番ビルド |
オープンデータソースにはキーは不要です。独自のバックエンドを使う場合は、VITE_SUPABASE_URL と VITE_SUPABASE_PUBLISHABLE_KEY を .env.local に設定してください。ブラウザーに渡されるのは VITE_ が付いた変数だけです。サービスロールキーや有料キーは絶対に設定しないでください。
ライセンスと帰属表示
コードは Apache-2.0 です。データは対象外です。
オープンデータだけで構築されたプロダクトでは、この違いは見た目以上に重要です。ライセンスの対象はこのリポジトリに含まれるもの、つまりスコアリングコア、データ取り込みパイプライン、インターフェースです。各データセットには独自の条件が適用されるため、ライセンスはデータセットに対する権利を付与しません。
| 要件 | |
|---|---|
| ODbL — OpenStreetMap、家賃規制データセット、BDCom 2023 | 帰属表示と継承ライセンスが必要です。再利用する場合は、© OpenStreetMap contributors と表記してください |
| Licence Ouverte 2.0 — Base Adresse Nationale、Géorisques、Sirene | ソースと更新日を明記してください |
| CC BY 4.0 — CAMS Europe / Copernicus | 帰属表示が必要です |
BDCom 2017 と 2020 は再配布できません。 これらのライセンスは 2023 年版とは異なります。そのため、データベースには各版の publicly_redistributable フラグがあり、匿名の呼び出し元にはその内容を開示しません。内容だけでなく、不在であることも隠すことで、非開示による情報漏えいも防いでいます。
このリポジトリにはデータ抽出物は含まれておらず、今後も含めてはなりません。含まれているのは、データを取得、モデル化、引用するコードです。
Ivan de Murard が作成しました。
このアプローチや MCP レイヤーに関心がありますか?issue を作成してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。