文章封面

YESCMS MCP 插件配置教程：让 AI 工具直接发布文章

YESCMS MCP 插件的目标，是让 AI 工具通过 MCP 协议对接 YESCMS，直接完成文章档案类目读取、文章配图上传、Markdown 文章发布等操作。

本文以当前项目中的 YESCMS.McpServer 和 to-cms 技能为例，说明完整配置方式。

一、整体结构

当前方案由三部分组成：

YESCMS.McpServer：真正被 MCP 宿主启动的服务。
YESCMS.McpConfig：辅助生成 Codex、Cursor、Claude Code、opencode 配置片段的配置生成器。
to-cms 技能：负责把对话、笔记、草稿或 Markdown 内容整理成可发布的 CMS 文章。

MCP Server 提供三个核心工具：

yescmslistcategories：读取 YESCMS 文章档案类目。
yescmsuploadarticle_image：上传文章配图到 /api/UpLoad/ArticleImage。
yescmspublisharticle：调用 /api/Article/PublishFromAI 发布 AI 生成的 Markdown 文章。

二、统一启动方式

为了避免 Windows、Linux、macOS 配置不一致，推荐所有平台统一使用 dotnet 启动 dll：

dotnet YESCMS.McpServer.dll

也就是说，MCP 配置中不要把 YESCMS.McpServer.exe 作为通用启动方式，而是统一写成：

command = dotnet
args = YESCMS.McpServer.dll

这样 Windows、Linux、macOS 都可以使用同一套配置结构，只需要替换 dll 的实际路径。

当前构建输出目录为：

D:\Projects\yescms\bin_mcp\Debug

MCP Server 文件为：

D:\Projects\yescms\bin_mcp\Debug\YESCMS.McpServer.dll

YESCMS.McpServer 已配置为不生成 YESCMS.McpServer.exe，避免误导用户错误配置。

三、Codex 配置示例

在 Codex 的 MCP 配置中添加：

[mcp_servers.yescms]
command = "dotnet"
args = ["D:\\Projects\\yescms\\bin_mcp\\Debug\\YESCMS.McpServer.dll"]

[mcp_servers.yescms.env]
YESCMS_BASE_URL = "https://www.example.com"
YESCMS_AI_TOKEN_FILE = "D:\\secrets\\yescms-ai-token.txt"

其中 YESCMSBASEURL 是 YESCMS 网站地址，YESCMSAITOKEN_FILE 指向保存 AI Token 的本地文件。

正式使用时，不建议把 token 明文写进技能、文章内容或对话中。更推荐使用 YESCMSAITOKENFILE、YESCMSAITOKENCOMMAND 或 Windows Credential Manager。

四、Cursor 配置示例

在项目的 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "yescms": {
      "command": "dotnet",
      "args": [
        "D:\\Projects\\yescms\\bin_mcp\\Debug\\YESCMS.McpServer.dll"
      ],
      "env": {
        "YESCMS_BASE_URL": "https://www.example.com",
        "YESCMS_AI_TOKEN_FILE": "D:\\secrets\\yescms-ai-token.txt"
      }
    }
  }
}

Linux 或 macOS 中只需要把路径换成对应系统路径。

五、Claude Code 配置示例

Claude Code 可以通过命令添加 MCP：

claude mcp add yescms \
  --env YESCMS_BASE_URL=https://www.example.com \
  --env YESCMS_AI_TOKEN_FILE=D:\secrets\yescms-ai-token.txt \
  -- dotnet D:\Projects\yescms\bin_mcp\Debug\YESCMS.McpServer.dll

Linux 或 macOS 示例：

claude mcp add yescms \
  --env YESCMS_BASE_URL=https://www.example.com \
  --env YESCMS_AI_TOKEN_FILE=/opt/secrets/yescms-ai-token.txt \
  -- dotnet /opt/yescms/bin_mcp/Debug/YESCMS.McpServer.dll

六、opencode 配置示例

在 opencode.jsonc 中添加：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "yescms": {
      "type": "local",
      "command": [
        "dotnet",
        "D:\\Projects\\yescms\\bin_mcp\\Debug\\YESCMS.McpServer.dll"
      ],
      "enabled": true,
      "environment": {
        "YESCMS_BASE_URL": "https://www.example.com",
        "YESCMS_AI_TOKEN_FILE": "D:\\secrets\\yescms-ai-token.txt"
      }
    }
  }
}

七、to-cms 技能配置

to-cms 技能用于把已有内容整理成适合发布到 YESCMS 的文章。

当前技能目录为：

D:\Program\.codex\skills\to-cms\SKILL.md

根据个人 Codex 配置约定，自定义技能应存放在：

D:\Program\.codex\skills

添加或修改技能后，执行同步脚本：

D:\Program\.codex\setup-codex-skills.ps1

同步后，Codex 会在用户目录下创建技能入口：

%USERPROFILE%\.codex\skills\to-cms

八、to-cms 的关键规则

发布文章时，to-cms 应遵循这些规则：

正文使用 Markdown。
发布前通过 yescmslistcategories 读取档案类目。
不能默认选择类目，必须让用户确认发布到哪个档案类目。
如果类目包含分组，需要同时确认 groupID。
必须生成文章标题、摘要、SEO 关键词和文章标签。
发布前应上传封面图，并把封面图 URL 写入 coverImageUrl。
Markdown 正文第一行应插入封面图。
不要在技能、文章 JSON 或正文中写入 token。

九、推荐配置流程

完整流程如下：

构建 MCP 项目。
确认 YESCMS.McpServer.dll 已生成。
在 Codex、Cursor、Claude Code 或 opencode 中配置 MCP。
使用 YESCMSAITOKEN_FILE 或其他安全方式登记 token。
启动宿主工具并确认 MCP 工具可用。
配置并同步 to-cms 技能。
使用 to-cms 生成文章。
发布前选择文章档案类目和分组。
上传封面图。
调用 YESCMS 发布接口。

完成后，AI 就可以从普通对话、笔记、访谈记录或 Markdown 草稿中，生成结构完整、带标签和 SEO 信息的 YESCMS 文章，并通过 MCP 工具完成发布。