# @arii/boomtick-mcp 中文文档

规范地址：https://npmcn.com/package/%40arii/boomtick-mcp/

版本：0\.11\.0
npm 元数据更新时间：2026-11-06T21:48:32.677Z
中文译文更新时间：2026-11-06T19:11:45.872Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40arii/boomtick-mcp
原文对照：https://npmcn.com/package/%40arii/boomtick-mcp/?lang=original
项目主页：https://github.com/arii/boomtick#readme
源码仓库：https://github.com/arii/boomtick

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：856 kB，158 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：24\.x
- 运行依赖：3 个
- 首次发布：2026-07-20T22:13:10.096Z
- 最新版本发布：2026-11-06T21:48:32.314Z
- 近 30 天下载量：2550（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

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

## 安装

```sh
npm install @arii/boomtick-mcp
```

也可以使用：`pnpm add @arii/boomtick-mcp`、`yarn add @arii/boomtick-mcp`、`bun add @arii/boomtick-mcp`

## README

# 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`在你的路径.

### 安装

```bash
# 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`:

```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` 目录 :

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

## 使用量

### 运输

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

```bash
node dist/index.js
```

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

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

```bash
# 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`

详细核查步骤见 [文件/测试](https://npmcn.com/package/%40arii/boomtick-mcp/docs/testing.md)。 。 。 .

## 常见问题

### @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 和提交记录判断。