内容
贝尤特MCP服务器
用于阿拉伯联合酋长国房地产搜索的MCP（模型上下文协议）服务器，通过Bayut API。 通过Claude Desktop和其他AI助手实现直接的房地产搜索和市场分析。
## 功能
### 🏠 核心功能
- **位置搜索** - 阿联酋位置（城市、社区、建筑）的自动补全
- **房地产搜索** - 销售/租赁房地产的广泛筛选选项
- **房地产详情** - 包括照片、平面图、代理详情的完整信息
- **交易历史** - 迪拜房地产的历史价格数据
- **市场分析** - 特定区域的快速市场总结和趋势
- **AI估值** - 具有可比销售和租赁收益率的TruEstimate™市场价值估算
### 💡 使用场景
- **投资研究** - 在迪拜和阿拉伯联合酋长国搜索和分析房地产
- **市场情报** - 跟踪价格趋势和交易历史
- **房地产估值** - 使用置信度获得AI驱动的市场价值估算
- **租赁收益率分析** - 比较不同区域的可比数据回报
- **黄金签证规划** - 搜索符合签证要求的房地产投资组合
- **房地产比较** - 使用详细筛选器评估多个列表
- **尽职调查** - 在购买前使用市场可比数据验证房地产价格
## 安装
### 先决条件
- Python 3.10 或更高版本
- [Claude Desktop](https://claude.ai/download)
- [RapidAPI 账户](https://rapidapi.com/taviansol/api/uae-real-estate2) 以及阿拉伯联合酋长国房地产API订阅
### 步骤 1：安装依赖项
```bash
pip install mcp httpx
```
### 步骤 2：获取 API 密钥
1. 在 [RapidAPI](https://rapidapi.com/taviansol/api/uae-real-estate2) 注册
2. 订阅阿拉伯联合酋长国房地产API（免费计划：750 次请求/月）
3. 从仪表板复制您的API密钥
### 步骤 3：配置 Claude Desktop
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
添加此配置：
```json
{
"mcpServers": {
"bayut": {
"command": "python",
"args": ["/absolute/path/to/bayut_mcp/server.py"],
"env": {
"RAPIDAPI_KEY": "your-rapidapi-key-here"
}
}
}
}
```
⚠️ **重要：** 使用 `server.py` 的绝对路径
### 步骤 4：重启 Claude Desktop
完全退出并重启Claude Desktop以加载MCP服务器。
## 使用方法
配置完成后，您可以直接通过Claude与Bayut交互：
### 示例查询
**位置搜索：**
```
"查找迪拜南部的地点ID"
```
**房地产搜索：**
```
"显示迪拜南区500k AED以下的单间公寓"
"在Business Bay找到1卧室的公寓出租"
```
**市场分析：**
```
"迪拜码头单间公寓的平均价格是多少？"
"显示迪拜南区过去一年的交易历史"
"获取Elite Residences 3, Unit 710的市场估值"
```
**投资规划：**
```
"寻找5处房产，总价值不超过200万AED，年租赁收益率至少7%"
"比较JVC和International City的租赁收益率"
"估计该房产的市场价值和租赁收益率"
```
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `search_locations` | 搜索阿拉伯联合酋长国地点，支持自动补全 |
| `search_properties` | 具有广泛筛选选项的房地产搜索 |
| `get_property_details` | 特定房产的完整详情 |
| `get_transactions` | 用于价格分析的交易记录 |
| `get_market_summary` | 地点的快速市场概览 |
| `get_tru_estimate` | 具有可比数据和趋势的AI驱动房产估值 |
## 高级用法
### 房地产搜索筛选
```python
search_properties(
purpose="for-sale", # 或 "for-rent"
locations_ids=[3355], # 迪拜南区
category="apartments",
rooms=[0], # 单间
price_max=500000,
area_min=300,
is_furnished=True,
sort_by="lowest_price"
)
```
### 交易分析
```python
get_transactions(
purpose="for-sale",
locations_ids=[3355],
category="apartments",
beds],
start_date="2024-01-01",
_date="2024-12-31"
)
```
### 值
获取具有可比销售和租赁数据的AI驱动市场估算：
```python
get_tru_estimate(
location_id="15974", # 建筑位置ID
unit_number="710" # 单元编号
)
```
返回：
估算市场价值** 及置信度
- **可比销售** （最近类似房产销售）
- **可比租赁类似房产租赁）
- **2年价格趋势** （历史价格变动）
- **收益率预测** （总收益率和净收益率）
- **服务费用** 和维护成本
替代标识：
```python
# 使用产权证
get_tru_estimate(title_deed="25671", year="2022")
# 使用Oqood
get_tru_estimate(oqood="161920", year="2023")
# 使用DEWA编号
get_tru_estimate(dewa="392315580")
```
## 故障排除
### "无可用工具"
- 检查 `claude_desktop_config.json` 语法
- 验证 `server.py` 的绝对路径
- 确保已设置API密钥
- 重启Claude Desktop
### "401 未授权"
- API密钥不正确或丢失
- 在配置文件中检查密钥
### "模块 'mcp' 未找到"
```bash
pip install mcp httpx
```
### "404 未找到"
- 确保您已在RapidAPI上订阅了阿拉伯联合酋长国房地产API
- 基础URL应为：`https://uae-real-estate2.p.rapidapi.com`
## 开发
### 项目结构
```
bayut_mcp/
├── server.py # 主要MCP服务器
├── pyproject.toml # 包配置
├── README.md # 文档
├── QUICKSTART.md # 快速设置指南
└── examples.py # 使用示例
```
### 贡献
欢迎贡献！请随时提交拉取请求。
1. 复刻仓库
2. 创建功能分支（`git checkout -b feature/AmazingFeature`）
3. 提交更改（`git commit -m 'Add some AmazingFeature'`）
4. 推送到分支（`git push origin feature/AmazingFeature`）
5. 打开拉取请求
## 资源
- [阿拉伯联合酋长国房地产API文档](https://rapidapi.com/taviansol/api/uae-real-estate2)
- [RapidAPI中心](https://rapidapi.com/taviansol/api/uae-real-estate2)
- [MCP文档](https://modelcontextprotocol.io)
- [Claude Desktop](https://claude.ai/download)
- [Bayut.com](https://www.bayut.com) - 数据源
## 许可证
MIT许可证 - 参见LICENSE文件了解详情
## 支持
如有问题或疑问：
- 在GitHub上打开问题
- 查看 [RapidAPI支持](https://rapidapi.com/taviansol/api/uae-real-estate2) 以获取API问题
## 致谢
- 使用 [FastMCP](https://github.com/jlowin/fastmcp) 构建
- 由 [阿拉伯联合酋长国房地产API](https://rapidapi.com/taviansol/api/uae-real-estate2) 提供支持
- 阿联酋房地产数据来自 [Bayut.com](https://www.bayut.com)
- TruEstimate™ 估值由AI市场分析提供支持
---
**为Claude Desktop构建** | **阿拉伯联合酋长国房地产数据由Bayut提供**
