成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

ScriptXeno:CLAUDE.md + blog-mcp——人写正文、机械发布交给本地 MCP

对照个人博客:手写 front matter/标签大小写/外置图床/双 GitHub 账号易错;披露自研 blog-mcp 与手搓 YAML 序列化、标签纠错与 scoped 发布;不代你产量、不外推。

场景说明

面向一人静态博客、研究与成文仍想自己做、却在 Jekyll/Chirpy 机械步骤反复翻车的作者:把「再让模型整篇代写」写成可对账的约定文档+本地 MCP 发布工具链,区别于周刊五段流水线与顾问秘书。

案例叙事

01他们做了什么

Nakshatra Ranjan Saha(OCEANOFANYTHING / ScriptXeno)在个人博客《How I Run This Blog with Claude Code, a CLAUDE.md File, and a Custom MCP Server (Real Setup, 2026)》(页内 Posted Aug 19, 2026;JSON-LD datePublished 2026-08-19 → 2026-08-19;canonical scriptxeno.github.io)写明:一人技术博客保持更新的「无聊真相」——研究、起草、逐句编辑仍自己做;Claude Code 读仓库根 CLAUDE.md(记录本仓真实约定),再加自研本地 MCP server blog-mcp 处理易错机械步骤。

CLAUDE.md 钉死的坑包括:Chirpy 主题在本仓全量 vendored(不能只信 gem 文档);permalink 为 /posts/:title/,乱改会静默打断历史链接;jekyll-archives 下标签/分类大小写敏感(「Tech」与「tech」会变两个归档;现存语料甚至标签 ai 与分类 AI 并存);图片走外置 GitHub Pages 仓而非本仓 assets,并涉及与日常 gh 凭证分离的 ScriptXeno 账号。blog-mcp 提供列表/读写文、手搓 front matter 序列化(裸 YYYY-MM-DD、flow 数组、固定 image 字段序;仅改正文时原样回贴 front matter)、相对已发布语料纠标签大小写、按帖建图床仓与上传、按站点真实品牌色生成缩略图提示,以及一次 scoped commit/push 发布。作者强调工具是为去掉「成品草稿→正确上线」的琐碎,不是代写文章。本场景据此输出「约定文档+发布 MCP」提纲。禁止建议无人值守对任意私有仓 force-push。

02实际效果

  • 源披露 CLAUDE.md 约定集、blog-mcp 工具面(手搓 YAML 序列化、标签和解、外置图床、scoped 发布)以及「人写正文、工具做机械步骤」边界等作者口径;属一人 Jekyll/Chirpy 博客叙事,不可外推为你的更新频率、阅读量或写作省时。
  • 能把「让模型整站代写代发」与「人编辑 + 本地 MCP 只碰格式/标签/图床/push」拆开。
  • 为 gray-matter 写回污染、标签大小写分裂归档、双 GitHub 账号推错仓提供提问清单。

03值得知道

  • 强绑定该仓 Chirpy vendored 与多账号 GitHub 布局;换主题/托管需重写约定与工具。
  • MCP 仍可能推错;scoped push 前要人看 diff。
  • 上面写的是作者个人实践帖,不是 Anthropic MCP 官文。

04可复制提示词

博客约定 + 发布 MCP 简报

你是静态博客工具链顾问。只根据用户约束写提问清单,不要编造已上线 MCP。

生成器与主题:{{stack}}
标签大小写规则:{{tag_rules}}
图床/多账号:{{images_auth}}
正文是否人写:{{human_draft}}

输出 Markdown:
1. CLAUDE.md 必记坑清单
2. MCP 工具边界(序列化/标签/图床/push)
3. 禁止代写正文的操作协议
4. 人工看 diff 门禁
禁止建议 force-push;禁止声称已自动日更。

front matter 污染复盘提纲

一次保存后日期带上 T00:00:00Z 或 tags 被打成 block list,请写复盘提纲。

diff 摘要:{{diff}}

输出:
1. 是通用 YAML 写回还是手搓序列化被绕过
2. 「仅改正文则原样回贴 front matter」补丁
3. 下次验收标准
4. 人工确认清单
不要伪造「序列化已永不出错」。

怎么做

  1. 粘贴站点生成器约定(permalink/标签大小写/图床账号),以及正文是否必须人写
  2. Agent 按实践帖输出:CLAUDE.md 必记坑→MCP 工具边界(序列化/标签和解/图床/scoped push)→人工审 diff 提问清单
  3. 人工保留研究与逐句编辑;Agent 不代你声称已自动写稿

实用提示

  • 源帖:gray-matter 默认写回会把日期扩成带时间戳、打散 tags 数组——解析用库、写出用手搓序列化器
  • 与 Alejandro 周刊五段流水线不同:本条明确人写正文,MCP 只做机械发布;亦非顾问秘书
#blog-mcp#CLAUDE.md#Jekyll#Chirpy#发布工具链