@arii/boomtick-mcp

中文文档
0.11.0发布于 2026/11/07ES Module构建来源已验证近 30 天下载 2550

Bomtick MCP 指南: 公关救援+合并冲突代理

中文使用文档
文档目录19 节
  1. 特征
  2. QQ 工具
  3. 资源
  4. QQ 提示
  5. 脚本
  6. 安全第一
  7. 设置
  8. 先决条件
  9. 安装
  10. 通过 MCP 客户端进行手动配置( 如 Claude 桌面, 光标)
  11. 配置
  12. 使用量
  13. 运输
  14. 可流取的 HTTP 传输和远程联网访问
  15. 释放进程
  16. 未来路线图
  17. 内容Ops + Merch 合规
  18. UX 递归+ Spec- Driven 重新设计
  19. 发展

Bomtick MCP: 公关救援+合并冲突代理

一个模型上下文协议(MCP)服务器,旨在赋予AI代理以结构化访问GitHub Pull Request,寄存器状态,CI日志和验证工具的能力.

特征

QQ 工具

  • GitHub 操作:搜索公关,获得diffs,检测合并冲突,打开替换公关,并进行分解评论.
  • Repo 行动:检查已更改文件,取出包脚本,地图应用路线,并读取CI日志.
  • 验证:孤立地修复分支创建,并运行验证套房(Tests,Lighthouse,Playwright).
  • Jules 操作: 创建,监控,并与宏代理Jules会话互动.

资源

  • repo://package-json: 访问根包列表.
  • repo://design-tokens: 访问UI设计符.
  • repo://diff/{prNumber}: 访问完整的PR diff文本.
  • repo://ci/{prNumber}: 访问详细的CI检查结果和日志.

QQ 提示

  • prompt://conflict-scout公关需要救援.
  • prompt://pr-consolidation: 分析和建议合并重叠公关的指导方针.
  • prompt://repo-context: 在修复前收集上下文.
  • prompt://repair-agent: 应用最小的安全修复.
  • prompt://verifier-agent:证明修复工程.
  • prompt://pr-writer:写专业替换PR摘要.

脚本

  • scripts/create_instructions.sh: 生成 pr-consolidation.prompt.md 基于 PR 重叠的指令文件.

安全第一

  • 孤立的工作树:所有修复和合并操作都发生在临时git工作树上,以防止您本地的工作目录发生突变.
  • 安全壳:所有命令都通过一个许可列表加以限制,并带有自动符号编辑和超时.
  • 写出守护符: 变相操作(承诺、分支创建、公关开放)需要明确 writeMode: true 或者说 pushMode: true 旗帜.

设置

先决条件

  • 节点.js 22
  • pnpm 第10页
  • GitHub CLI (英语:gh在你的路径.

安装

# From repository root
pnpm --filter @arii/boomtick-mcp run build

# Register boomtick-mcp across installed agent hosts automatically
td mcp install --execute

通过 MCP 客户端进行手动配置( 如 Claude 桌面, 光标)

在您的 MCP 客户端配置中添加以下内容( 例如 ) . claude_desktop_config.json:

{
  "mcpServers": {
    "boomtick": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_pat",
        "GITHUB_OWNER": "your_org",
        "GITHUB_REPO": "your_repo",
        "BOOMTICK_REPO_PATH": "/absolute/path/to/repo"
      }
    }
  }
}

配置

创建一个 .env 文档中 boomtick-mcp 目录 :

GITHUB_TOKEN=your_pat
GITHUB_OWNER=your_org
GITHUB_REPO=your_repo
BOOMTICK_REPO_PATH=/path/to/repo

使用量

运输

通过 stdio 运行服务器( 本地 CLI 工作流程和 Docker 容器动作的理想) :

node dist/index.js

可流取的 HTTP 传输和远程联网访问

对于主机代理机(如Google双子代理端点,远程DevAI仪表板),需要使用Bearer sord / OAuth 2.1认证和RFC 9728元数据发现进行网络传输:

# Run HTTP entrypoint directly
node dist/http.js --port 3000 --bearer-token secret123

# Or via CLI binary entrypoint
boomtick-mcp-http --port 3000 --bearer-token secret123

# Or using environment variables
MCP_TRANSPORT=http PORT=3000 BOOMTICK_MCP_BEARER_TOKEN=secret123 node dist/index.js

网络端点 & RFC 9728 发现

  • GET /.well-known/oauth-protected-resource: OAuth 2.0 / 2.1 保护资源元数据发现端点(RFC 9728).
  • GET /sse:用于MCP连接的服务器-恒星事件(SSE)流端点(通过Bearer sord)被保护.
  • POST /messages?sessionId=...: MCP客户端 JSON-RPC 消息发布端点(通过Bearer sorder被保护).

释放进程

  1. 运行测试 : pnpm test
  2. 运行 evals : pnpm run run-evals
  3. 更新版本 : pnpm run release:patch (或 minor编号 :major(中文(简体) )
  4. 构建 : pnpm run build
  5. 推动更改和标记.

未来路线图

内容Ops + Merch 合规

  • content.validate_affiliate_disclosure:确保亚马逊强制性措辞.
  • content.check_trademark_risk博客文章中可能存在的商标问题.
  • amazon.validate_affiliate_card:验证附属链接和产品名称匹配媒体.

UX 递归+ Spec- Driven 重新设计

  • ux.capture_screenshot: 抓取多视图口截图.
  • ux.compare_screenshots: 使用 Playwright 检测视觉回归.
  • ux.run_accessibility_check: 自动轴心审计.

发展

  • 构建数字 : pnpm run build
  • 测试数字 : pnpm test
  • 校验数字 : pnpm run run-evals

详细核查步骤见 文件/测试。 。 。 .

版本与发布记录

@arii/boomtick-mcp 共发布 21 个版本,首次发布于 2026/07/21;过去 12 个月发布了 21 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.0latest2026/11/07今天
0.10.02026/11/034 天前
0.9.02026/11/034 天前
0.8.12026/11/035 天前
0.8.02026/11/025 天前
0.7.42026/11/016 天前

关于 @arii/boomtick-mcp 的常见问题

@arii/boomtick-mcp 是什么?

Bomtick MCP 指南: 公关救援+合并冲突代理

如何安装 @arii/boomtick-mcp?

在项目目录运行 npm install @arii/boomtick-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 boomtick-mcp、boomtick-mcp-http,可以用 npx boomtick-mcp 直接运行。

@arii/boomtick-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/arii__boomtick-mcp 是否存在。

@arii/boomtick-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@arii/boomtick-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js 24.x。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@arii/boomtick-mcp 可以商用吗?

@arii/boomtick-mcp 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@arii/boomtick-mcp 的下载量有多少?

根据 npm 官方下载统计,@arii/boomtick-mcp 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,550 次,日均约 85 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@arii/boomtick-mcp 还在维护吗?

最新版本 0.11.0 发布于 2026/11/07(今天);至今共发布 21 个版本,其中过去 12 个月发布了 21 个;首次发布于 2026/07/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。