ACW Tools MCP

MCP (Model Context Protocol) 工具集，用于在 Cursor 中通过自然语言下载 ACW 规则，并自动收集和上传 AI 对话记录。

Cursor 配置方法

配置文件位置

~/.cursor/mcp_settings.json (或通过 Cursor Settings → MCP → Edit MCP Settings)

配置示例（Token 认证）

{
  "mcpServers": {
    "acw-tools": {
      "command": "npx",
      "args": ["-y", "@bangdao-ai/acw-tools@latest"],
      "env": {
        "ACW_BASE_URL": "https://acw.bangdao-tech.com",
        "ACW_TOKEN": "your-token-here"
      }
    }
  }
}

配置说明:

• ACW_BASE_URL: ACW 服务端地址（默认：https://acw.bangdao-tech.com）
• ACW_TOKEN: 你的用户 Token（必需，在 ACW 平台个人中心 → Token 管理中创建）

连接自检

在 Cursor 对话中让助手调用 MCP 工具 check_acw_connection（或说明「检查 acw-tools 与云端是否通」）。该工具会：

• 请求无鉴权配置接口，确认 ACW_BASE_URL 网络可达；
• 在配置了 ACW_TOKEN 时调用技能搜索接口，确认 Token 被服务端接受。

注意：Cursor 界面里「MCP 已连接」只表示编辑器与本进程的 stdio 已建立，不能代替上述云端检测。安装失败时请先完成下文排障再谈 Token。

安装与排障（Windows 编译失败 / Node 版本）

首选方案（推荐，可视为「直接解决」）：让 运行 npx 的 Node 为 22 LTS 或更新（约 22.5+）。此时使用 Node 内置 node:sqlite 读取 Cursor 的 state.vscdb，不需要 better-sqlite3 的原生 .node，不需要 Visual Studio Build Tools，postinstall 在检测到内置模块后会直接通过。

包行为说明

• better-sqlite3 已改为 optionalDependency：在旧 Node 上仍尝试安装；安装失败时 不会 拖垮整包安装。
• postinstall 顺序：① 若当前 Node 提供 node:sqlite → 立即成功；② 否则再校验 / 修复 better-sqlite3（OSS 预编译、npm rebuild 等）；③ 仍失败则打印 结构化诊断（Node 版本、ABI、路径、已执行步骤）。

仍使用 Node 20 时

• 依赖可选安装成功的 better-sqlite3（预编译或本机编译）。Windows 常需 VS Build Tools；与 Cursor / npx 所用 Node 主版本 需一致，否则易出现 ABI 不匹配。
• 避免多份 Node 混用导致 npx 与预期版本不一致。

macOS / Linux 旧 Node

• 编译失败时：xcode-select --install 或 build-essential（及 Python 3，若 npm 提示），再重装本包。

平台侧数据说明（对话采集导出）

从 ACW 导出的执行明细中：

• tool_name：对 Cursor 上报的 MCP 工具名会在采集侧归一为 配置名:工具名（如 acw-tools:download_rule），便于统计；内置工具（如 read_file_v2）保持原名。
• execution_time：对应 AI 气泡在客户端记录的一段耗时；timing_info.measurementKind 为 cursor_client_timing 时表示来自 Cursor 的 clientSettleTime - clientRpcSendTime，通常覆盖模型推理与编排，不是「单个 MCP 工具 RPC 耗时」。为 estimated_turn_latency 时表示无原生 timing 时的兜底估算，见该 JSON 内 measurementNote。

许可证

MIT License

作者

邦道科技 - 产品技术中心