content-qa-mcp

編集コンテンツのQA（品質保証）のためのMCP（Model Context Protocol）サーバーです。Claudeに記事を渡すと、すべての指摘に修正案が付属する指摘レポートを返します。正しいだけでなく、そのまま使えるレポートになります。

指摘と修正案がセットになるという契約はテストスイートで強制されます。実行可能な修正案のない指摘を出力するチェックは、スイートを失敗させます。

機能

4つのツール、1つのプロンプト、APIキーは不要です。すべてローカルで動作します。

さらに、qa_reviewプロンプトがフルレポートを駆動し、モデルに編集上の判定を求めます。指摘を和らげたり捏造したりすることはありません。

すべての指摘は1つのオブジェクトです：

{
  "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件の指摘が含まれており、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セッションで「この記事に対して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シムを経由した登録は、Windowsではしばしば接続に失敗します。生成されたプロセスがstdioを正しくアタッチできないためで、その失敗は静かに発生します。絶対パスのnode.exeとスクリプトパスを使えば、毎回確実に動作します。このリポジトリのエンドツーエンドテストも同じパターン（process.execPath）を使用しています。

設計ノート

• チェックはsrc/checks/内の純粋関数であり、MCPなしでインポート可能です。サーバーはそれらの上に置かれた薄いプロトコル層であり、同じチェックをCI、gitフック、パイプラインで実行できます。

• SEOチェックは意図的に範囲を限定しています。 整形式のCMS記事出力（WordPress、Ghost、静的サイトジェネレーター）を正規表現抽出で解析します。汎用のHTMLパーサーではなく、敵対的なマークアップに耐えようとはしません。境界を明示することは、存在しないふりをするより優れています。

• プレーンテキスト入力はSEOチェックをスキップし、偽の「タグ欠落」指摘を報告しません。

• 定型フレーズリストは文字列ではなくクラスを禁止します。 各エントリはパターンであるため、決まり文句を一言で言い換えたものも検出されます。

これが存在する理由

これは、私が有料で行っている編集QA業務の実践方法を、エージェントが呼び出せるツールとしてパッケージ化したものです。ここに組み込まれているルールは次のとおりです。何が問題かを指摘するだけで次の行動を指示しないQAレポートは、単に作業を誰かの机に移すだけです。指摘は修正案とともに公開されるか、公開されないかのどちらかです。

ライセンス

MIT