content-qa-mcp

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 замечания по намеренно сломанной фикстурной статье, отчёт можно перегенерировать командой 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

Регистрация (CLI Claude Code):

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 on this article» или используйте промпт 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-проверка ограничена намеренно. Она разбирает корректный HTML из CMS (WordPress, Ghost, генераторы статических сайтов) с помощью регулярных выражений. Это не универсальный HTML-парсер, и она не пытается пережить некорректную разметку. Лучше честно обозначить границы, чем делать вид, что их нет.

• Для обычного текста SEO-проверка пропускается — вместо того чтобы выдавать фальшивые замечания о «отсутствующих тегах».

• Список штампов запрещает классы, а не конкретные слова. Каждый шаблон — это паттерн, поэтому перефразировка штампа в одно слово всё равно будет поймана.

Зачем это нужно

Это рабочий метод моей платной редакторской проверки, упакованный в инструменты, которые может вызывать агент. Правило простое: отчёт, который говорит, что не так, но не говорит, как исправить, просто перекладывает работу на чужой стол. Замечания публикуются только вместе с исправлениями — или не публикуются вовсе.

Лицензия

MIT