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	并排比较两个街区
get_suspicious_listings	检测定价异常的房源
get_liquidity	市场流动性指数
get_agency_leaderboard	按交易量排列的中介机构排名

传输方式

stdio（本地）

node bin/mcp-server

适用于 Claude Desktop、opencode、Cursor——从 stdin 读取 JSON-RPC，并写入 stdout。

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