YESCMS MCP 插件配置教程：让 AI 工具直接发布文章
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 提供三个核心工具：
- yescms_list_categories：读取 YESCMS 文章档案类目。
- yescms_upload_article_image：上传文章配图到 /api/UpLoad/ArticleImage。
- yescms_publish_article：调用 /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"
其中 YESCMS_BASE_URL 是 YESCMS 网站地址，YESCMS_AI_TOKEN_FILE 指向保存 AI Token 的本地文件。
正式使用时，不建议把 token 明文写进技能、文章内容或对话中。更推荐使用 YESCMS_AI_TOKEN_FILE、YESCMS_AI_TOKEN_COMMAND 或 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。
- 发布前通过 yescms_list_categories 读取档案类目。
- 不能默认选择类目，必须让用户确认发布到哪个档案类目。
- 如果类目包含分组，需要同时确认 groupID。
- 必须生成文章标题、摘要、SEO 关键词和文章标签。
- 发布前应上传封面图，并把封面图 URL 写入 coverImageUrl。
- Markdown 正文第一行应插入封面图。
- 不要在技能、文章 JSON 或正文中写入 token。
九、推荐配置流程
完整流程如下：
- 构建 MCP 项目。
- 确认 YESCMS.McpServer.dll 已生成。
- 在 Codex、Cursor、Claude Code 或 opencode 中配置 MCP。
- 使用 YESCMS_AI_TOKEN_FILE 或其他安全方式登记 token。
- 启动宿主工具并确认 MCP 工具可用。
- 配置并同步 to-cms 技能。
- 使用 to-cms 生成文章。
- 发布前选择文章档案类目和分组。
- 上传封面图。
- 调用 YESCMS 发布接口。
完成后，AI 就可以从普通对话、笔记、访谈记录或 Markdown 草稿中，生成结构完整、带标签和 SEO 信息的 YESCMS 文章，并通过 MCP 工具完成发布。
