Jun Yuan
返回列表

当博客遇上 MCP:让 AI Agent 帮你维护内容

当博客遇上 MCP:让 AI Agent 帮你维护内容
关于这个博客系统如何通过 MCP/OpenAPI 与 AI Agent 连接,以及我做这个功能的初衷、流程与思考。

很长一段时间里,运营一个个人博客意味着两类我并不喜欢的体力活:手动调整布局,以及把零散的想法一行行变成完整文章。我真正在乎的是内容本身,围绕它的“管道工程”反而成了负担。这篇文章记录的,就是把这部分管道工程拿掉的尝试——把博客自己的内容 API 暴露成 MCP 服务,让 AI Agent 去做重复劳动,而我只负责方向和审美。

MCP 真正改变了什么

Model Context Protocol (MCP) 的核心思想很简单:不要靠提示词“教” AI 认识你的 API,而是把 API 描述一次(这里通过 OpenAPI 文档),再由一个适配器把每个端点变成带类型的工具。Agent 发现这些工具的方式,和发现其他能力一样——靠名称、schema 和描述。

这个博客系统本来就有一套按租户隔离的内容 API:创建文章、上传媒体、管理分类、创建和更新项目。它只缺一座桥。把本地的 OpenAPI-to-MCP 适配器指向 https://jyuan.online/api/v1/openapi.json 之后,这些端点全部变成了 Agent 可以直接调用的工具。不需要在服务端部署 MCP,也不需要新增后端——只是一个本地进程,读取 spec,通过 stdio 对外提供 MCP 能力。

我做这个功能的初衷

我不想再:

  • 为每篇文章手动调布局;
  • 把图片一张张传进媒体库;
  • 重复填写元数据、slug 和摘要;
  • 把发布当成和写作抢时间的 chores。

我想要的工作流是:用自然语言描述我想要什么,Agent 负责机械步骤——起草、附图、分类、保持结构一致。发布前我仍然会审阅——API 默认以草稿创建,正是为了这一点——但那无聊的 80% 已经消失了。

发布流程

下面是 Agent 通过 MCP 发布文章时遵循的流程:

Code and automation workflow

现在 Agent 能做什么

  • 从 Markdown 创建文章草稿,支持标题、列表、代码块(含 Mermaid)、引用和通过 ![alt](media:MEDIA_ID) 插图。
  • 上传媒体,支持 multipart 文件或从 sourceUrl 导入,并复用返回的 mediaId。
  • 创建或复用分类,让文章组织更有序,无需手动搭建。
  • 管理项目:创建草稿、更新多语言内容、追加带提交链接的进展记录。
  • 租户安全:所有请求都发往租户主机,API Key 与主机交叉校验。

我的一些思考

  1. 默认值比功能更重要。 创建默认为草稿,是把 Agent 从风险变成助手的最关键设计。
  2. Markdown 作为交换格式被低估了。 服务端把 Markdown 转成富文本,Agent 无需了解 CMS 的内部块模型就能产出结构化内容。
  3. 媒体 ID 作为一等引用让图片与文章解耦,同一张图可以复用,正文也更可读。
  4. 天然支持双语意义重大。API 接受 localized 条目,一次请求就能携带两种语言版本,并按语言分别计算 SEO。
  5. 最后一公里仍然属于人类。 Agent 可以起草,但语气、准确性和发布决策应该由人来把关。自动化应该消除摩擦,而不是消除判断。

结语

把博客连上 MCP 服务,并没有让它变得“全自动”——而是让它变得低摩擦。写作仍然是我的;布局、媒体处理和琐事不再是我。如果你也在做内容平台,暴露一个干净的 OpenAPI 接口,再让本地适配器完成 MCP 转换,是把 AI Agent 引入工作流中投入产出比最高、风险最低的方式之一。

—— 由 AI Agent 协助起草,经人类审阅。

相关文章

你可能也会喜欢