pacer-mcp

pacer-mcp

🪦 已停用。 这个独立的 PAT-over-stdio 服务已无法访问 Pacer API。所有工具都会提示改用核心内置的进程内 （“内联”）Pacer MCP 连接器，该连接器以托管的 “Pacer” 连接器形式 在 claude.ai / Claude Cowork 上提供（工具显示为 mcp__…Pacer__…）。这个独立二进制通过网络向 portal.pacerrev.io 调用 API，而该地址现在会将未经过身份验证的 API 调用重定向到 HTML 登录页面；进程内连接器会直接分发到相同的 /api/v1 处理程序， 无需经过网络，也不会与 API 主机发生偏差。请从 MCP 客户端配置中 移除此服务。 以下安装和工具文档仅供历史参考。

一个 MCP 服务，可将 pacer/core API 端点作为原生工具提供给 Claude Code（以及任何其他支持 MCP 的客户端）。一个二进制文件，使用 stdio 传输，简单省心。

安装

macOS（Homebrew）

brew install STR-Consulting/tap/pacer-mcp

Windows（Scoop）

scoop bucket add pacer https://github.com/STR-Consulting/scoop-bucket
scoop install pacer-mcp

不熟悉编程？请参阅 docs/windows-setup.md，其中提供了可直接复制粘贴给 AI 助手的提示词。

Linux（二进制 tarball）

适用于服务端和自动化场景。将 <version> 替换为版本号，并选择 amd64 或 arm64：

curl -fsSL https://github.com/STR-Consulting/mcp/releases/latest/download/pacer-mcp_<version>_linux_amd64.tar.gz | tar -xz
sudo install pacer-mcp /usr/local/bin/

或者使用 OCI 镜像：ghcr.io/str-consulting/pacer-mcp:latest（linux/amd64 + linux/arm64）。

从源代码安装

go install github.com/STR-Consulting/pacer-mcp@latest

设置

将以下内容添加到 MCP 配置中（例如项目中的 .mcp.json 或 Claude Code 用户配置）：

{
  "mcpServers": {
    "pacer": {
      "command": "pacer-mcp",
      "env": {
        "PACER_CORE_URL": "https://portal.pacerrev.io",
        "PACER_CORE_TOKEN": "pat_..."
      }
    }
  }
}

环境变量	描述	默认值
PACER_CORE_URL	pacer/core 应用的基础 URL（PAT JSON API 挂载于此）	https://portal.pacerrev.io
PACER_CORE_TOKEN	个人访问令牌，格式为 pat_...	（未设置）

安装后运行 health_check，确认服务可以访问 core。

PAT 由 core 管理员通过 pacer pat create --user <email> --label <name> 创建；需要 employee 或更高权限，并通过 Authorization: Bearer pat_... 发送。

工具

每个工具的完整描述（注意事项、适用场景、参数）都会在注册时返回给 MCP 客户端——Agent 会在选择工具时看到这些信息。以下列表仅供快速查阅。

运维

工具	功能
health_check	对 Pacer API 执行 ping，并报告配置和可达性

投资组合基础信息

工具	功能
list_briefable_portfolios	列出活跃投资组合（可选使用 q 筛选名称）
list_portfolio_teams	批量列出每个投资组合的通知团队（RM/RD/Jon）
get_portfolio_team	获取单个投资组合的通知团队
list_portfolio_units	单元清单：卧室数、类型、托管/活跃状态、位置
list_portfolio_reservations	指定日期范围内的预订（按 check_in/check_out/booked_on 筛选）

业绩表现

工具	功能
get_portfolio_pacing	近期预订及同比租金/ADR/ABW/LOS 和异常评分
get_portfolio_metrics_ytd	本年度与上一年度截至目前的对比：收入、ADR、入住率、RevPAR、LOS、数量
get_portfolio_market_metrics	单月本年度与上一年度对比及市场基准差异；可选进行分解

Guesty PMS

工具	功能
guesty_pricing_config	单元定价意图：基础价格、费用、最少/最多晚数、因子、渠道设置
guesty_reservation_promotions	某月预订中由渠道应用的促销（Airbnb、Vrbo 等）

客户健康度

工具	功能
get_client_health_brief	某投资组合最新（或指定日期）的情绪简报
upsert_client_health_brief	记录简要情绪简报（1-5 分 + 阶段 + 载荷）
list_client_health_briefs	仪表板视图：截至指定日期每个投资组合的最新简报
get_client_health_scoring_config	评分权重、标签和层级阈值
upsert_intel_brief	发布完整的情报简报（Postgres + ClickUp 任务 + BigQuery 镜像）

KeyData

工具	功能说明
list_managed_keydata_units	获取 KeyData 客户账户由 Pacer 管理的单元 UUID

未封装：POST /portfolios/{p}/intel-brief/attachments（multipart 二进制上传）。MCP 没有适用于 multipart 的自然处理方式。

开发

go build -o pacer-mcp .
go test ./...
golangci-lint run --fix ./...

发布流程已自动化——推送 v* 标签后，GitHub Actions 会构建 darwin-arm64、windows-amd64 和 linux-{amd64,arm64} 二进制文件（以及 ghcr.io/str-consulting/pacer-mcp OCI 镜像），然后更新 Homebrew tap 和 Scoop bucket，并发布到 MCP Registry。

许可证

MIT