Nuxt CMS

next generation CMS

MCP 接入文档

详细了解什么是 MCP 以及如何将本系统的能力开放给各大 AI 助手(如 Trae, Cursor, Claude Desktop 等)。

什么是 MCP (Model Context Protocol)?

MCP 是由 Anthropic 开源的标准协议,它允许 AI 模型(如 Claude、Cursor 等客户端)安全地连接和操作本地或远程数据源。 通过此功能,您的 AI 助手可以直接读取本系统的文章列表、详情,甚至直接发布或更新文章,实现 AI 原生驱动的内容管理系统。

已开放的 AI 技能 (Tools)

  • list_articles: 查询文章列表(支持分页)
  • get_article: 查看单篇文章的详细内容
  • create_article: 让 AI 帮您撰写并发布新文章
  • update_article: 更新和润色已有文章
  • delete_article: 删除指定文章

如何获取 API 密钥?

在接入任何 AI 客户端之前,您必须先获取访问权限:

  1. 前往 API 密钥管理 页面。
  2. 点击右上角的「新建密钥」按钮。
  3. 输入一个易于识别的名称(如 Trae 接入密钥)。
  4. 务必复制生成的密钥并妥善保存,因为它只显示一次。

推荐接入地址

  • 正式推荐地址:https://vjack50.top/api/mcp?key=sk_您的API密钥

因为当前域名存在一些使用问题,目前我们**优先推荐直接使用服务器 IP** 进行连接。 如果您访问的是本地环境,则会显示为 localhost 或 127.0.0.1。

关于 MCP 与 HTTP/SSE 协议

根据 MCP (Model Context Protocol) 官方最新规范,对于远程服务器(Remote Server),官方的标准 HTTP 传输协议就是 SSE (Server-Sent Events) + POST。本系统已基于最新的 @modelcontextprotocol/sdk 重构,提供最标准、最稳定的 HTTP/SSE 连接支持。

Skills 与 MCP 的关系

建议同时阅读并安装 Skills 接入文档 中的运营规则。MCP 提供的是“物理连通性”,而 Skill 提供的是“AI 应该如何使用这些工具的工作规范”。

集成指南:优先以 Trae 为例

Trae 已经原生支持了 MCP 协议的配置。您可以直接将以下配置加入到 Trae 的设置中。 注意:请将 sk_您的API密钥 替换为您实际申请到的真实密钥(请注意保密,不要将其提交到代码仓库)。

Trae 配置示例:

{
  "mcpServers": {
    "Nuxt CMS MCP": {
      "url": "https://vjack50.top/api/mcp?key=sk_您的API密钥"
    }
  }
}

集成指南:第三方客户端 (Cursor / Claude Desktop 等)

很多现代 AI IDE 和客户端同样原生支持了 HTTP/SSE 模式,集成非常简单:

  1. 在 AI 客户端设置中找到 MCP (Model Context Protocol) 选项。
  2. 点击添加新的 MCP Server。
  3. 类型 (Type / Transport): 必须选择 SSE
  4. URL: 填写 https://vjack50.top/api/mcp?key=sk_您的API密钥
  5. 请求头 (可选): 如果客户端支持自定义 Header,您也可以选择不在 URL 中明文传递 key,而是配置:
    Authorization: Bearer sk_您的API密钥
  6. 保存并测试连接。连接成功后,AI 即可在对话中自动调用系统接口。
Nuxt CMS

© 2026 Nuxt Full-Stack Architecture Demo. 构建现代化全栈应用.