REP Helper

@rephelper/mcp-server

适用于 REP Helper 的 MCP 服务 — 让 AI Agent 管理房地产活动和房产，以跟踪 IRS REP（房地产专业人士）资格。

前提条件

• Node.js 20+ — 下载
• REP Helper Elite 账户 — rephelper.ai
• API 令牌 — 在 REP Helper → Settings → API Tokens 中创建

快速开始

1. 创建 API 令牌

在 REP Helper 应用中，前往 Settings → API Tokens → Create Token。授予所需权限（例如，活动读取/创建、房产读取）。复制令牌 — 它只会显示一次。

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"
      }
    }
  }
}

Gemini CLI — 编辑 ~/.gemini/settings.json：

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

Windsurf — 编辑 .windsurf/mcp.json：

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

3. 开始使用

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

“今天记录在 123 Main St 进行 2 小时的物业管理”

“显示我上周的所有活动”

“在 Austin, TX 78701 的 456 Oak Ave 添加一处新的长期出租房产”

可用工具

活动

工具	说明
list_activities	列出活动，可按房产、日期范围和类别筛选
get_activity	按 ID 获取单项活动
create_activity	记录新活动，可选附加行程和证据文件
update_activity	更新现有活动
delete_activity	软删除活动（72 小时内可恢复）

房产

工具	说明
list_properties	列出房产，可按类型筛选
get_property	按 ID 获取单项房产
create_property	添加新出租房产
update_property	更新现有房产
delete_property	软删除房产（72 小时内可恢复）

活动类别

• Management & Operations
• Maintenance & Repairs
• Development & Construction
• Acquisition & Brokerage
• Administrative & Compliance

证据文件

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

• 支持的格式：JPEG、PNG、WebP、PDF
• 每项活动最多 3 个文件
• 每个文件最大 10MB

示例：“记录一项维护活动，并附加 /Users/me/Downloads/receipt.jpg 中的收据”

行程

每项活动最多关联 3 个行程。行程的出行时间会自动计入活动时长。

环境变量

变量	必填	默认值	说明
REPHELPER_API_TOKEN	是	—	您的 API 令牌（rh_live_* 格式）
REPHELPER_API_URL	否	https://api.rephelper.ai	API 基础 URL 覆盖值

API 文档

交互式 API 文档见 api.rephelper.ai/docs。

OpenAPI 规范见 api.rephelper.ai/openapi.yaml。

故障排除

“REPHELPER_API_TOKEN environment variable is required”

• 确保已在 MCP 配置中添加包含令牌的 env 区块。

“Token is invalid or not found”

• 仔细检查令牌值。令牌应以 rh_live_ 开头。
• 令牌可能已被撤销 — 请在 REP Helper 中创建新令牌。

“Permission denied: Token lacks X permission”

• 您的令牌缺少所需权限。在 REP Helper → API Tokens 中编辑令牌并添加该权限。

“API access requires an Elite subscription”

• API 令牌仅适用于 Elite 方案。请在 rephelper.ai 升级。

“Rate limited: Too many requests”

• 稍等片刻后重试。限制：每分钟读取 60 次、写入 30 次、删除 5 次。

许可证

MIT