realestate-rag-mcp

RealEstate MCP

どのような課題を解決するのですか？

オーストラリアの不動産サイトでは、一般的に郊外エリアを基準にした柔軟性のないフィルターが使われていますが、実際の検索方法には合っていません。たとえば、「Box Hill High Schoolの学区内にある、リノベーション済みの3ベッドルームの住宅」のような検索は、単純にはできません。

このプロジェクトでは、LLMとMCPを活用して、自然言語による柔軟な物件検索を実現します。

公開されている物件データを使って、オーストラリアの不動産を検索したり、質問したりできます。このプロジェクトはツールを提供し、自然言語による物件検索APIを提供するFastAPIサーバーを実行します。

システムには以下が含まれます。

1. 物件データをダウンロードし、セマンティック検索用のベクトルデータベースに登録するインデックス作成パイプライン
2. さまざまな検索ツールを備えたMCP サーバー
3. クエリを送信して結果を表示するデモクライアント

例

Enter your query (or type 'quit' to exit): list 3 renovated houses with 4 bedrooms in Camberwell high school zone

Here are some renovated houses with 4 bedrooms located in the Camberwell High School zone:

1. **3/2-4 Georgina Parade, Camberwell VIC 3124**
   - Immaculately renovated throughout, this property boasts sleek modern style in a peaceful and private location. It's close to Hartwell Shopping Centre, Willison Park, and public transport.

2. **2/22 Russell Street, Camberwell VIC 3124**
   - This single-level boutique residence has been stylishly refurbished. Located on a prestigious tree-lined street, it offers sun-drenched dimensions for luxurious living and is near Camberwell Junction.

3. **6 Donna Buang Street, Camberwell VIC 3124**
   - Positioned in a picturesque, tree-lined street, this property presents an opportunity to build a family home or develop further. It's conveniently located for access to local schools.

Each property offers unique features and is ideally situated within the Camberwell High School zone.

1. run_ingest_pipeline でデータをダウンロードする

このスクリプトは、指定した都市と期間の物件情報およびオークション結果をダウンロードします。

使い方：

python -m cli.run_ingest_pipeline <city> <start_date> <end_date>

• <city>：都市名（例：melbourne）
• <start_date>：開始日。形式は YYYY-MM-DD です（例：2025-02-01）
• <end_date>：終了日。形式は YYYY-MM-DD です（例：2025-05-10）

例：

python -m cli.run_ingest_pipeline melbourne 2025-02-01 2025-05-10

これにより、2025年2月1日から2025年5月10日までのメルボルンの物件データがダウンロードされます。

---

2. populate_collection でベクトルデータベースにデータを登録する

このスクリプトは、セマンティック検索用に、物件情報をChromaベクトルデータベースのコレクションに登録します。

使い方：

python -m cli.populate_collection.py <collection_name> <property_details_path>

• <collection_name>：登録先のChromaDBコレクション名（例：melbourne）
• <property_details_path>：物件情報JSONLファイルのパス（例：downloaded_data/property_details.jsonl）

例：

python -m cli.populate_collection.py melbourne downloaded_data/property_details.jsonl

---

3. サーバーとデモクライアントを実行する

python -m cli.server

および

python -m cli.client