@rephelper/mcp-server

REP Helper 的 MCP 服务器 — 让 AI 代理管理房地产活动和房产，以进行 IRS REP（房地产专业人士）资格跟踪。

先决条件

• Node.js 20+ — 下载

• REP Helper Elite 账户 — rephelper.ai

• API 令牌 — 在 REP Helper → 设置 → API 令牌中创建一个

快速入门

1. 创建 API 令牌

在 REP Helper 应用中，前往 设置 → API 令牌 → 创建令牌。授予您需要的权限（例如，活动读取/创建，房产读取）。复制令牌 — 它仅显示一次。

2. 配置您的 AI 客户端

将以下内容添加到您的客户端 MCP 配置中：

Claude Desktop — 编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

Claude Code — 编辑 .claude/settings.json 或使用 /mcp 命令：

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

Cursor — 编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "rephelper": {
      "command": "npx",
      "args": ["-y", "@rephelper/mcp-server"],
      "env": {
        "REPHELPER_API_TOKEN": "rh_live_your_token_here"
      }
    }
  }
}

3. 开始使用

让您的 AI 助手管理您的房地产活动：

"今天记录 2 小时的 123 Main St 物业管理"

"显示我上周的所有活动"

"添加一个新的长期租赁房产，地址为 456 Oak Ave, Austin, TX 78701"

可用工具

活动

房产

活动类别

• Management & Operations（管理与运营）

• Maintenance & Repairs（维护与维修）

• Development & Construction（开发与建设）

• Acquisition & Brokerage（收购与经纪）

• Administrative & Compliance（行政与合规）

证据文件

在创建或更新活动时，您可以从本地文件系统附加证据文件：

• 支持格式：JPEG, PNG, WebP, PDF

• 每个活动最多 3 个文件

• 每个文件最大 10MB

示例："记录一项维护活动并附加来自 /Users/me/Downloads/receipt.jpg 的收据"

行程

每个活动最多可关联 3 个行程。行程的旅行时间会自动添加到活动时长中。

环境变量

API 文档

交互式 API 文档可在 api.rephelper.ai/docs 获取。

OpenAPI 规范可在 api.rephelper.ai/openapi.yaml 获取。

故障排除

"REPHELPER_API_TOKEN environment variable is required"

• 确保您已将 env 块添加到包含令牌的 MCP 配置中。

"Token is invalid or not found"

• 仔细检查您的令牌值。它应该以 rh_live_ 开头。

• 令牌可能已被撤销 — 在 REP Helper 中创建一个新的。

"Permission denied: Token lacks X permission"

• 您的令牌没有所需的权限。在 REP Helper → API 令牌中编辑令牌以添加它。

"API access requires an Elite subscription"

• API 令牌仅在 Elite 计划中提供。请在 rephelper.ai 升级。

"Rate limited: Too many requests"

• 请稍后再试。限制：60 次读取/分钟，30 次写入/分钟，5 次删除/分钟。

许可证

MIT