为什么使用 CLI 替代 MCP？

相比于需要维持 SSE 长连接的 MCP 协议，CLI 提供了一种 解耦、稳定、无状态 的替代方案。 通过安装独立的 CLI 客户端，AI Agent（如 Trae）可以通过执行终端命令直接获取结构化数据（JSON），完成文章的增删改查。这不仅消除了网络桥接的麻烦，还让这套工具能被人类开发者或 CI/CD 自动化脚本使用。

1. 配置内部 NPM 仓库 (强烈推荐)

为了保障核心代码安全和加速下载，我们部署了内部私有的 Verdaccio NPM 仓库。安装 CLI 前，请先配置 npm registry：

npm config set registry https://npm.vjack50.top/

（注：如果域名无法解析，可以使用备用 IP 地址：http://npm.vjack50.top/）

2. 安装 CLI 工具

在配置好内部仓库后，在您的本地环境（或允许 AI 访问的终端环境）全局安装 CLI：

npm install -g nuxt-cms-cli

3. 配置服务器地址

告诉 CLI 您的 CMS 云端服务器地址：

cms config set baseUrl https://vjack50.top

4. 登录与鉴权

CLI 不仅支持账号密码登录，也支持使用 API Key：

cms config set token sk_您的API密钥

或者使用账号密码登录，Token 将被安全地保存到本地：

cms auth login --email admin@example.com --password 您的密码

5. AI Agent 使用范例 (支持 JSON)

在 Trae 等支持执行本地终端命令的 AI 助手中，当 AI 需要管理文章时，它可以直接调用 cms 命令，并加上 --json 参数获取纯净的结构化数据，彻底避免解析人类友好的高亮文本而报错。

• 获取文章列表： cms article list --page 1 --json
• 获取文章详情： cms article get 12 --json
• 创建文章： cms article create --title "AI 自动生成" --slug "ai-post" --content-file ./draft.md --json
• 删除文章： cms article delete 12 --json

6. 配合 Skills 使用

建议您同时安装 Skills 规则。新版的 Skill 文件已经同时支持了 MCP 和 CLI 两种调用模式。当您让 AI “帮我管理文章”时，Skill 会引导 AI 优先使用 cms 命令行工具完成操作。