content-qa-mcp

一个用于文章内容质量保障（QA）的 MCP（Model Context Protocol）服务器。把一篇文章交给 Claude，就能得到一份问题报告，其中每一条发现都附加了修复建议，所以这份报告不只是"正确的"，而是直接可用的。

"发现必带修复"这一约定由测试套件强制执行：任何只输出发现、却不给出可操作修复的检查，都会导致测试套件失败。

它能做什么

四个工具、一个提示词、零 API 密钥。一切都在本地运行。

另加一个 qa_review 提示词，用来驱动完整报告，并要求模型给出编辑裁决——既不淡化问题，也不凭空捏造问题。

每个发现都是一个对象：

{
  "check": "seo-onpage",
  "severity": "high",
  "excerpt": null,
  "finding": "No meta description.",
  "fix": "Add a 120-155 character meta description that states the article's payoff and includes the keyword once."
}

完整运行示例见 samples/sample-report.md：该样本包含 22 条针对刻意破坏的 fixture 样板文章得出的发现，可用 npm run sample 重新生成。

Related MCP server: pangram-editorial

在 Claude Code 中安装与注册

git clone https://github.com/Alvi-808/content-qa-mcp.git
cd content-qa-mcp
npm install
npm test        # 14 tests, includes a real MCP client/server handshake

注册（Claude Code CLI）：

claude mcp add content-qa -- node /absolute/path/to/content-qa-mcp/src/server.js

已验证可用：

content-qa: C:\Program Files\nodejs\node.exe C:\...\content-qa-mcp\src\server.js - √ Connected

然后，在 Claude Code 会话中：对这篇文章执行 "run qa_full_report ..."，或使用 qa_review 提示词。

用 claude mcp remove content-qa 移除。

Windows 注意事项（大多数教程忽略的部分）

在 Windows 上，需要注册 stdio MCP 服务器并使用 node.exe 的绝对路径和脚本：

claude mcp add content-qa -- "C:\Program Files\nodejs\node.exe" "C:\path\to\content-qa-mcp\src\server.js"

凡是经由 npx 或 .cmd shim 运行的注册，在 Windows 上常常会静默地无法连接，因为被生成的进程根本无法正确挂接 stdio。使用绝对路径的 node.exe 加上脚本路径则每次都能成功。本仓库的端到端测试也使用了相同的模式（process.execPath）。

设计说明

• 各检查项都是纯函数，位于 src/checks/ 中且不需要 MCP 即可引入。服务器只是在它们之上的一层薄协议层，所以同样的检查可以运行在 CI、Git hook 或流水线中。

• SEO 检查的范围是有意设定的。 它用正则解析格式良好的 CMS 文章输出（WordPress、Ghost、静态站点生成器）。它并不是一个通用 HTML 解析器，也不会去对抗那些恶意标记。明确边界总比装作没有边界好。

• 纯文本输入会跳过 SEO 检查，而不是报出虚假的"缺失标签"问题。

• 套话列表封禁的是"一类话"，而不是具体某个字符串。 每个条目都是一个模式，所以即使把某个陈词滥调换个说法，也照样会被抓到。

为什么会有这个东西

这是我做付费编辑内容 QA 时的实际操作流程，把它打包成了可以让 agent 调用的工具。它蕴含的规则是：一份只说哪里错了却不说接下来怎么做，不会把活儿推给别人去做罢了。要么把修复方案一起交付，要么就不要发布这个发现。

可扩展性

在某次