Real Estate Capitale MCP

Real Estate Capitale — MCP サーバー

モロッコのラバト、サレ、テマラでの不動産検索、物件評価、市場分析、リード管理に対応する MCP サーバーです。

クイックスタート

# Install
npm install

# Set database URL
cp .env.example .env
# Edit .env with your PostgreSQL connection string

# Start stdio server (for Claude Desktop, opencode, Cursor)
npm start

# Or start HTTP/SSE server
npm start:http

17 個のツール

ツール	説明
search_listings	条件（種別、所在地、予算、面積、部屋数）を指定して物件を検索します
get_listing	ID を指定して物件の詳細を取得します
estimate_property	地区と面積から物件価格を推定します
get_market_trends	地区ごとの価格推移を取得します
get_quartier_stats	地区ごとの集計統計（価格／m²、件数）を取得します
list_quartiers	利用可能な地区をすべて一覧表示します
list_villes	利用可能な都市をすべて一覧表示します
create_lead	リード（顧客の連絡先）を作成します
get_comparables	評価用に類似物件を検索します
get_investor_alerts	割安な物件を特定します
get_price_analytics	価格／m²の分布を分析します
get_rental_yield	地区ごとの賃貸利回りを取得します
get_market_predictions	90 日間の価格予測を取得します
get_quartier_comparison	2 つの地区を並べて比較します
get_suspicious_listings	価格の外れ値を検出します
get_liquidity	市場の流動性指数を取得します
get_agency_leaderboard	取引量に基づく不動産会社のランキングを取得します

トランスポート

stdio（ローカル）

node bin/mcp-server

Claude Desktop、opencode、Cursor 向けです。標準入力から JSON-RPC を読み取り、標準出力に書き込みます。

HTTP/SSE（リモート）

node bin/mcp-server-http
# Listens on port 3001

エンドポイント：

• GET / — サーバー情報（Streamable HTTP の検出）
• POST / — 同期 JSON-RPC
• GET /sse — SSE ストリーム
• POST /messages?sessionId=... — SSE セッションメッセージ
• GET /health — ヘルスチェック

設定

Claude Desktop

config/claude-desktop.json を Claude Desktop の MCP 設定にコピーするか、claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "realestatecapitale": {
      "command": "node",
      "args": ["/path/to/rabatrealestate/bin/mcp-server"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mubawab"
      }
    }
  }
}

opencode

{
  "mcp": {
    "realestatecapitale": {
      "type": "local",
      "command": ["node", "bin/mcp-server"],
      "env": { "DATABASE_URL": "..." }
    }
  }
}

リモート（HTTP）

{
  "mcp": {
    "realestatecapitale": {
      "type": "remote",
      "url": "https://realestatecapitale.ma/mcp"
    }
  }
}

クエリツール

# List tools
node bin/query "tools/list"

# Call a tool
node bin/query 'tools/call {"name":"list_villes","arguments":{}}'

# Query remote server
MCP_URL=https://realestatecapitale.ma/mcp node bin/query "tools/list"

テスト

npm test

アーキテクチャ

┌─────────────┐     stdio      ┌──────────────┐
│ Claude Desktop│ ◄──────────── │ bin/mcp-server│
│ opencode     │               │ (stdio)       │
└─────────────┘               └──────┬───────┘
                                      │
┌─────────────┐     HTTP/SSE  ┌──────┴───────┐
│ Remote AI   │ ◄──────────── │ bin/mcp-     │
│ clients     │               │ server-http  │
└─────────────┘               │ (port 3001)  │
                              └──────┬───────┘
                                     │
                              ┌──────┴───────┐
                              │ src/core/     │
                              │ mcp-core.js   │
                              │ (17 tools)    │
                              └──────┬───────┘
                                     │
                              ┌──────┴───────┐
                              │ PostgreSQL    │
                              │ (mubawab)     │
                              └──────────────┘

ライセンス

MIT