ACW Rules MCP Tool

MCP (Model Context Protocol) 工具，用于在 Cursor 中通过自然语言下载 ACW 规则压缩包并自动解压到工作目录。

功能特性

• 🔐 安全认证：使用用户名和密码验证身份
• 🔍 智能搜索：支持规则名称模糊匹配和规则编号精确匹配
• 📦 自动解压：下载后自动解压到当前工作目录
• 🔄 覆盖更新：自动覆盖已存在的文件，实现规则更新
• 💬 自然语言：通过自然语言与 Cursor 交互下载规则

Cursor 配置方法

配置文件位置

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

推荐配置（使用 npx，自动更新）

{
  "mcpServers": {
    "acw-rules": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "ACW_BASE_URL": "http://localhost:8080",
        "ACW_USERNAME": "your-username",
        "ACW_PASSWORD": "your-password"
      }
    }
  }
}

配置说明:

• command: 使用 npx 运行（推荐）
• args:
  • -y: 自动确认，跳过交互式提示
  • [email protected]: 使用指定版本（推荐锁定版本号）
• env: 环境变量配置
  • ACW_BASE_URL: ACW 服务端地址（必填）
  • ACW_USERNAME: 你的 ACW 平台用户名（必填）
  • ACW_PASSWORD: 你的 ACW 平台密码（必填）

💡 自动更新: 使用 @latest 标签，每次运行时 npx 会自动检查并使用最新版本，无需手动更新！

重启 Cursor

配置完成后重启 Cursor，MCP 工具将自动加载。

使用示例

按规则名称下载（模糊匹配）

请帮我下载邦道公司级规则1.0

或

请帮我更新邦道公司级规则1.0

AI 会自动将规则解压到当前工作区根目录。

按规则编号下载（精确匹配）

如果知道规则编号（RULE-xxx 格式），可以精确下载：

请帮我下载 RULE-001

指定目标目录

你也可以明确指定目标目录：

请帮我下载邦道公司级规则1.0 到 /Users/BaiGod/Documents/projects/acw

💡 提示: 通常情况下不需要指定目录，AI 会自动识别当前工作区并解压到正确位置。

处理多个匹配

当规则名称匹配到多个结果时，工具会列出所有匹配的规则，并提示使用规则编号精确下载：

找到 3 个匹配的规则，请使用规则编号精确下载：

1. 规则编号: RULE-001
   标题: 邦道公司级规则1.0
   描述: 公司级开发规范

2. 规则编号: RULE-002
   标题: 邦道公司级规则2.0
   描述: 公司级开发规范（新版）

3. 规则编号: RULE-015
   标题: 邦道公司级前端规则
   描述: 前端开发规范

使用示例: "请帮我下载 RULE-001"

常见问题

认证失败

错误信息: 认证失败: 用户名或密码错误

解决方法:

• 检查 MCP 配置中的用户名（ACW_USERNAME）和密码（ACW_PASSWORD）是否正确
• 确认账户已在 ACW 平台注册并激活

规则未找到

错误信息: 规则未找到: 未找到匹配的规则，请咨询训练师

解决方法:

• 检查规则名称拼写是否正确
• 尝试使用更精确的关键词
• 咨询训练师获取正确的规则名称或编号

网络连接问题

错误信息: 下载规则失败: fetch failed

解决方法:

• 检查 ACW_BASE_URL 配置是否正确
• 确认 ACW 服务端是否正常运行

许可证

MIT License

作者

邦道科技 - 产品技术中心