摘要:展开

最近给博客写了一个新的插件:Typecho MCP。

它会在 Typecho 内部提供一个符合 MCP(Model Context Protocol)的
Streamable HTTP 服务,让支持 MCP 的 AI 客户端可以直接读取和管理博客内容。
整个服务由 PHP 插件原生实现,不需要额外安装 Node.js,也不用单独运行 Docker
或常驻进程。

能做什么

目前插件提供以下 MCP 工具:

  • 查看博客版本、文章数量、附件类型等站点信息
  • 列出、搜索和读取文章
  • 创建文章或草稿
  • 修改正文、状态、分类、标签和评论设置
  • 查看分类和附件
  • 查看单个附件详情
  • 上传图片与普通文件
  • 删除指定附件(需要显式确认)
  • 读取和修改 Handsome 主题的文章头图、摘要等自定义字段

创建文章时默认保存为草稿,确认内容后再发布。插件不提供删除文章工具;
删除附件则必须显式确认,避免 AI 在未确认的情况下执行不可逆操作。

支持 Handsome 主题字段

除了 Typecho 自带的文章数据,插件还支持我当前使用的 Handsome 主题字段:

  • 手动摘要
  • 大头图和小头图
  • 头图版权说明
  • 头图显示位置与样式
  • 无头图时的个性化标徽或 Emoji
  • 文章过时提醒
  • 转载规则
  • 单篇 MathJax 设置
  • 前台 Markdown 解析器

因此 AI 不只是能写入正文,也能完成后台文章编辑页中大部分常用配置。例如,
先上传一张图片,再把返回的 URL 设置成文章头图,并同时填写摘要、分类和标签。

为什么直接做成 Typecho 插件

最初也考虑过单独运行一个 MCP 服务,不过对个人博客来说有些重:

  • 需要额外维护运行时和进程
  • 需要再配置一套数据库连接
  • 部署、更新和备份都更复杂

原生插件可以直接复用 Typecho 的数据库配置、附件上传规则和插件系统。MCP
端点跟随网站一起工作,启用插件后即可使用,部署成本更低。

安装与连接

项目已经以 MIT License 开源:

GreenTeodoro839/typecho-extensions - TypechoMcp

安装步骤:

  1. 下载仓库中的 TypechoMcp 目录。
  2. 将目录放入 Typecho 的 usr/plugins/。
  3. 在后台启用 Typecho MCP。
  4. 进入插件设置,保存并妥善保管自动生成的访问令牌。

MCP 地址为:

https://你的域名/action/typecho-mcp

客户端需要携带 Bearer Token:

Authorization: Bearer <插件设置中的访问令牌>

一个通用的连接信息示例:

{
  "name": "typecho",
  "url": "https://example.com/action/typecho-mcp",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}

不同 MCP 客户端的配置格式可能不同,但核心就是服务地址和鉴权请求头。

安全设计

博客写入接口不能只追求方便,因此插件做了几项限制:

  • 所有请求都必须通过随机 Bearer Token 鉴权
  • 远程连接建议只使用 HTTPS
  • 新文章默认保存为草稿
  • 不开放文章删除工具
  • 删除附件必须传入附件 cid 和 confirm=true
  • 文件扩展名沿用 Typecho 的附件白名单
  • MCP 文件上传设置独立的大小上限
  • 主题下拉选项使用严格枚举校验,避免写入无效配置

访问令牌不会出现在公开仓库中,每个站点在启用插件时自行生成。

当前版本

当前版本为 1.2.0,已经在 Typecho 1.3.0 和 PHP 8.2 环境完成文章
读取、创建、修改、附件上传、查看与删除,以及 Handsome 主题字段测试。

如果你也想让 AI 帮忙管理 Typecho 博客,可以前往 GitHub 查看源码和完整说明:

查看 Typecho MCP 源码

最后修改:2026 年 06 月 24 日
如果觉得我的文章对你有用,请随意转载