内容
# BrokerIA MCP 服务器
**巴西首个房地产 MCP 服务器。** 搜索房产、模拟融资、资质认定潜在客户、安排看房 — 直接从 Claude、Gemini、ChatGPT 或任何与 MCP 兼容的 AI 助手。
[](LICENSE)
[](https://modelcontextprotocol.io)
## 功能介绍
| 工具 | 描述 |
|------|-------------|
| `brokeria_buscar_imoveis` | 使用自然语言或筛选条件搜索 309+ 个房产，涵盖 10+ 家代理机构 |
| `brokeria_detalhes_imovel` | 完整的房产详情：照片、规格、价格、位置 |
| `brokeria_simular_financiamento` | 巴西抵押贷款计算器（SAC/PRICE 系统） |
| `brokeria_qualificar_lead` | 在 CRM 中注册潜在客户并自动分配经纪人 |
| `brokeria_agendar_visita` | 安排房产看房 |
## 快速开始
### Gemini CLI
```bash
gemini extensions install https://github.com/raklapimenta/brokeria-mcp-server
```
### Claude Desktop / Claude Code
添加到您的 MCP 设置：
```json
{
"mcpServers": {
"brokeria-imoveis": {
"url": "https://mcp.brokeria.com.br/mcp"
}
}
}
```
### 任意 MCP 客户端（Streamable HTTP）
连接至：`https://mcp.brokeria.com.br/mcp`
房产搜索无需身份验证。服务器使用 Streamable HTTP 传输（JSON-RPC 2.0）。
## 示例查询
尝试询问您的 AI 助手：
- "在 Campinas 找到一个 2 个卧室的公寓，价格低于 R$ 300,000"
- "显示 Jardim Botanico 中有 3 个卧室以上的待售房屋"
- "模拟 R$ 500,000 的抵押贷款，首付 R$ 100,000"
- "KasaMais 有哪些可用的房产？"
## 架构
- **运行时**: Cloudflare Workers（全球边缘）
- **数据库**: Supabase（PostgreSQL + pgvector，用于语义搜索）
- **搜索**: 混合 — 向量嵌入（OpenAI）+ 传统筛选条件
- **传输**: Streamable HTTP（MCP 2025-03-26 规范）
- **安全性**: 匿名读取访问，服务密钥用于写入（潜在客户/看房创建）
## 端点
| 路径 | 方法 | 描述 |
|------|--------|-------------|
| `/` | GET | 健康检查 + 服务器信息 |
| `/mcp` | POST | MCP JSON-RPC 端点 |
| `/mcp` | GET | 会话初始化 |
| `/mcp` | DELETE | 会话终止 |
| `/docs` | GET | API 文档 |
| `/privacy` | GET | 隐私政策（符合 LGPD） |
## 隐私
- 房产搜索是匿名的 — 不收集个人数据
- 潜在客户注册和看房安排仅存储自愿提供的联系信息
- 通过行级安全（RLS）实现多租户数据隔离
- 符合 LGPD — 完整的隐私政策，请访问 [mcp.brokeria.com.br/privacy](https://mcp.brokeria.com.br/privacy)
## 关于 BrokerIA
BrokerIA 是一个面向巴西房地产机构的 SaaS 平台，提供 WhatsApp 自动化、CRM、AI 驱动的销售助手和 Meta Ads 管理。此 MCP 服务器使我们的房产目录可供任何 AI 助手访问。
**网站**: [brokeria.com.br](https://brokeria.com.br)
**MCP 端点**: [mcp.brokeria.com.br](https://mcp.brokeria.com.br)
## License
MIT
