使用说明
🏠 MCP房地产-法国房地产MCP服务器
MCP（模型上下文协议）服务器，用于分析和搜索法国房地产机会，与Claude Desktop和Windsurf兼容。
🚀 安装
Prérequis
- Python 3.8或更高版本
- Git
手动安装
# 1. Cloner le repository
git clone https://github.com/votre-username/real-estate-mcp.git
cd real-estate-mcp
# 2. Créer l'environnement virtuel
python -m venv venv
# 3. Activer l'environnement virtuel
# Windows:
venv\Scripts\activate
# Unix/Mac:
source venv/bin/activate
# 4. Installer les dépendances
pip install -r requirements.txt
🤖 配置MCP
对于Claude Desktop
将此配置添加到文件中 claude_desktop_config.json :
视窗 : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"real-estate-mcp": {
"command": "C:\\chemin\\vers\\votre\\projet\\venv\\Scripts\\python.exe",
"args": ["C:\\chemin\\vers\\votre\\projet\\mcp_real_estate_server.py"],
"cwd": "C:\\chemin\\vers\\votre\\projet"
}
}
}
倾倒风帆
服务器通过集成MCP系统与Windsurf直接兼容。
安装测试
# Tester le serveur MCP
python mcp_real_estate_server.py
# Ou utiliser le script de démarrage
python start_server.py
🛠️ 功能
7个MCP工具可用
- 🔍 搜索属性 -使用高级过滤器搜索房地产
- 📊 分析市场 -按地理区域进行全面的市场分析
- 🏘️ get_neighborhood_info -关于社区的详细信息（交通、设施）
- ⚖️ 比较位置 -多个区域的多标准比较
- 📋 获取_属性_摘要 -房地产市场概述
- 💰 分析投资机会 -房地产租赁/商户投资机会分析
- 📈 比较投资策略 -投资策略比较
数据来源
- 房地产API -实时广告数据
- 地理数据 -地理编码和位置信息
- 市场分析 -房地产统计和趋势
- 投资计算 -租金盈利能力和潜在资本收益
📖 使用示例
在Antibes搜索工作室
Trouve-moi des studios de plus de 30m² à louer à Antibes
市场分析
Analyse le marché immobilier locatif à Lyon
投资比较
Compare les stratégies d'investissement locatif vs marchand de biens pour un appartement 3 pièces à 250 000€ à Marseille
🧪 测试和验证
# Activer l'environnement virtuel
venv\Scripts\activate # Windows
source venv/bin/activate # Unix/Mac
# Tester le serveur MCP
python mcp_real_estate_server.py
# Tester avec le script de démarrage
python start_server.py
🔧 发展
模块结构
mcp_real_estate_server.py-主MCP服务器src/main.py-业务逻辑和分析src/mcp_server.py-接口MCPsrc/dynamic_data_service.py-动态数据服务src/rental_analyzer.py-租赁投资分析仪src/dealer_analyzer.py-商品市场分析仪
📁 项目结构
real-estate-mcp/
├── 📂 src/ # Code source principal
│ ├── 🐍 main.py # Logique métier et analyses
│ ├── 🐍 mcp_server.py # Interface MCP
│ ├── 🐍 dynamic_data_service.py # Service de données
│ ├── 🐍 rental_analyzer.py # Analyse investissement locatif
│ ├── 🐍 dealer_analyzer.py # Analyse marchand de biens
│ └── 🐍 __init__.py # Module Python
├── 📂 config/ # Configuration
├── 📂 data/ # Données locales
├── 🐍 mcp_real_estate_server.py # Serveur MCP principal
├── 🐍 start_server.py # Script de démarrage
├── 📄 requirements.txt # Dépendances Python
├── 📄 .env # Variables d'environnement
└── 📄 README.md # Documentation
🐛 故障排除
导入或模块问题
# Vérifier l'environnement virtuel
python -c "import sys; print(sys.executable)"
# Réinstaller les dépendances
pip install -r requirements.txt --force-reinstall
# Vérifier les imports
python -c "from src.main import DynamicRealEstateMCP; print('Import OK')"
MCP配置问题
- 检查配置中的路径是否正确（使用绝对路径）
- 修改后重新启动Claude Desktop或Windsurf
- 检查MCP服务器日志（
mcp_server.log)
编码问题（Windows）
# Le serveur gère automatiquement l'encodage UTF-8
# Vérifiez les logs pour les erreurs d'encodage
type mcp_server.log
连通性测试
# Tester la communication MCP
python mcp_real_estate_server.py
# Le serveur doit démarrer sans erreur
🤝 贡献
- 分叉项目
- 创建功能分支（
git checkout -b feature/nouvelle-fonctionnalite) - 提交更改（
git commit -am 'Ajouter nouvelle fonctionnalité') - 向分支推（
git push origin feature/nouvelle-fonctionnalite) - 创建拉取请求
📄 许可证
该项目获得MIT许可。查看文件 许可证 更多详情。
🆘 支持
- 🐛 通过GitHub问题报告错误
- 💡 通过GitHub问题请求功能
- 📧 直接联系技术支持
