Real Estate Capitale MCP
Real estate MCP server for Morocco — search, valuation, market analysis, 17 tools.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http real-estate-capitale-mcp 'https://realestatecapitale.ma/mcp'
{
"mcpServers": {
"real-estate-capitale-mcp": {
"type": "http",
"url": "https://realestatecapitale.ma/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Real Estate Capitale — MCP Server
MCP server for real estate search, property valuation, market analysis, and lead management in Rabat, Salé, and Témara, Morocco.
Quick Start
# 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 Tools
| Tool | Description |
|---|---|
search_listings | Search properties with filters (type, location, budget, surface, rooms) |
get_listing | Get full listing details by ID |
estimate_property | Estimate property value by quartier and surface |
get_market_trends | Price trends over time by quartier |
get_quartier_stats | Aggregated stats per quartier (price/m², count) |
list_quartiers | List all available quartiers |
list_villes | List all available cities |
create_lead | Create a lead (contact client) |
get_comparables | Find similar listings for valuation |
get_investor_alerts | Identify undervalued properties |
get_price_analytics | Price/m² analysis with distribution |
get_rental_yield | Rental yield by quartier |
get_market_predictions | 90-day price predictions |
get_quartier_comparison | Compare two quartiers side-by-side |
get_suspicious_listings | Detect outlier pricing |
get_liquidity | Market liquidity index |
get_agency_leaderboard | Agency ranking by volume |
Transports
stdio (local)
node bin/mcp-server
For Claude Desktop, opencode, Cursor — reads JSON-RPC from stdin, writes to stdout.
HTTP/SSE (remote)
node bin/mcp-server-http
# Listens on port 3001
Endpoints:
GET /— Server info (Streamable HTTP discovery)POST /— Synchronous JSON-RPCGET /sse— SSE streamPOST /messages?sessionId=...— SSE session messagesGET /health— Health check
Configuration
Claude Desktop
Copy config/claude-desktop.json to your Claude Desktop MCP config, or add to 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": "..." }
}
}
}
Remote (HTTP)
{
"mcp": {
"realestatecapitale": {
"type": "remote",
"url": "https://realestatecapitale.ma/mcp"
}
}
}
Query Tool
# 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"
Testing
npm test
Architecture
┌─────────────┐ 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) │
└──────────────┘
License
MIT
الأسئلة الشائعة
ما هو Real Estate Capitale MCP؟
Real estate MCP server for Morocco — search, valuation, market analysis, 17 tools.
كيف أثبّت Real Estate Capitale MCP؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http real-estate-capitale-mcp 'https://realestatecapitale.ma/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Real Estate Capitale MCP إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Real Estate Capitale MCP مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Real Estate Capitale MCP؟
ينشره allamiwayl-27. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.