content-qa-mcp

Ein MCP-Server (Model Context Protocol) für redaktionelles Content-QA. Man legt Claude einen Artikel vor und erhält einen Befundbericht, in dem jeder Befund den passenden Fix direkt mitliefert – der Bericht ist nutzbar statt nur korrekt.

Dieses Prinzip „Befund mit Fix“ wird von der Testsuite durchgesetzt: Eine Prüfung, die einen Befund ohne umsetzbaren Fix erzeugt, lässt die Suite fehlschlagen.

Was es tut

Vier Tools, ein Prompt, null API-Schlüssel. Alles läuft lokal.

Außerdem gibt es einen qa_review-Prompt, der den kompletten Bericht anstößt und das Modell um ein redaktionelles Urteil bittet – ohne Befunde abzumildern oder zu erfinden.

Jeder Befund ist genau ein Objekt:

{
  "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."
}

Einen vollständigen Lauf mit samples/sample-report.md ansehen: 22 Befunde am absichtlich fehlerhaften Dummy-Artikel, regenerierbar mit npm run sample.

Related MCP server: pangram-editorial

Installieren und in Claude Code registrieren

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

Registrieren (Cloude Code CLI):

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

Verifiziert funktionsfähig:

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

In einer Claude-Code-Sitzung dann z. B. „run qa_full_review on this article“ sagen oder den qa_review-Prompt nutzen.

Entfernen mit claude mcp remove content-qa.

Windows-Hinweis (der Teil, den die meisten Tutorials weglassen

On Windows registriert man stdio-MCP-Server mit dem absoluten Pfad zu node.exe und dem Skript:

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

Registrierungen über npx oder einen .cmd-Shim führen unter Windows regelmäßig zu Verbindungsfehlern, weil der gestartete Prozess stdio nie korrekt anbindet – und der Fehler passiert still. Der absolute node.exe-Pfad plus Skriptpfad funktioniert dagegen zuverlässig. Der End-to-End-Test in diesem Repo nutzt genau dieses Muster (process.execPath).

Design-Anmerkungen

• Die Prüfungen sind reine Funktionen in src/checks/, die unabhängig von MCP importieren können. Der Server ist nur seine dünne Protokollschicht darüber, sodass dieselben Prüfungen auch in CI, in einem Git-Hook oder in einer Pipeline laufen können.

• Die SEO-Prüfung ist bewusst eng gefasst. Sie parst wohlgeformte CMS-Artikelausgaben (WordPress, Ghost, Static-Site-Generatoren) mit regex-Extraktion. Sie ist kein allgemeiner HTML-Parser und tut nicht so, als müsse sie gegen feindliches Markup funktionieren. Die Grenze zu benennen ist besser, als so zu tun, als gäbe es sie nicht.

• Reine-Text-Eingabe überspringt die SEO-Prüfung, statt erfundene „fehlende-Tags“-Befunde zu melden.

• Die Floskelliste verbietet Klassen, keine Strings. Jeder Eintrag ist ein Muster, sodass auch Ein-Wort-Umformulierungen einer Floskel erkannt werden.

Warum es das gibt

Das ist die Arbeitsmethode, die hinter meiner bezahlten redaktionellen QA-Arbeit steht – verpackt in Werkzeuge, die ein Agent aufrufen kann. Die Regel darin: Eine-QA-Bericht, der sagt, was angibt kaputt ist, ohne auch zu sagen, was zu tun ist, schafft die Arbeit nur auf den Schreibtisch von jemand anders. Befunde werden nur mit Fixes ausgeliefert – oder gar nicht.

Lizenz

MIT