content-qa-mcp

Un servidor MCP (Model Context Protocol) para el QA de contenido editorial. Apunta Claude a un artículo y obtén un informe de hallazgos donde cada hallazgo viene con la corrección adjunta, de modo que el informe sea utilizable y no solo correcto.

La suite de pruebas hace cumplir ese contrato de hallazgos con correcciones: una comprobación que emite un hallazgo sin una corrección aplicable hace fallar la suite.

Qué hace

Cuatro herramientas, un prompt, cero claves de API. Todo se ejecuta localmente.

Además, un prompt qa_review que guía el informe completo y pide al modelo un veredicto editorial sin suavizar ni inventar hallazgos.

Cada hallazgo es un objeto:

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

Consulta una ejecución completa en samples/sample-report.md: 22 hallazgos sobre el artículo de prueba deliberadamente roto, regenerable con npm run sample.

Related MCP server: pangram-editorial

Instalación y registro en 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

Registrar (CLI de Claude Code):

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

Verificado y funcionando:

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

Después, en una sesión de Claude Code: "ejecuta qa_full_report en este artículo" o usa el prompt qa_review.

Elimínalo con claude mcp remove content-qa.

Nota para Windows (la parte que la mayoría de los tutoriales omiten)

En Windows, registra los servidores MCP stdio con la ruta absoluta a node.exe y el script:

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

Los intentos de registro mediante npx o un shim .cmd suelen fallar al conectarse en Windows porque el proceso generado nunca asocia stdio correctamente, y el fallo es silencioso. Usar la ruta absoluta de node.exe junto con la ruta del script funciona siempre. La prueba de extremo a extremo de este repositorio usa el mismo patrón (process.execPath).

Notas de diseño

• Las comprobaciones son funciones puras en src/checks/, importables sin MCP. El servidor es una fina capa de protocolo sobre ellas, de modo que las mismas comprobaciones pueden ejecutarse en CI, un git hook o un pipeline.

• La comprobación SEO está acotada deliberadamente. Analiza la salida bien formada de artículos de CMS (WordPress, Ghost, generadores de sitios estáticos) mediante extracción con regex. No es un analizador HTML general ni intenta sobrevivir a marcado adversarial. Nombrar el límite es mejor que fingir que no existe.

• La entrada de texto plano omite la comprobación SEO en lugar de notificar falsos hallazgos de "etiqueta faltante".

• La lista de frases hechas prohíbe clases, no cadenas. Cada entrada es un patrón, así que las reformulaciones de un cliché que cambian una sola palabra siguen detectándose.

Por qué existe

Este es el método que sustenta mi trabajo de QA editorial remunerado, empaquetado como herramientas que un agente puede invocar. La regla que codifica: un informe de QA que dice qué está mal sin decir qué hacer a continuación solo traslada el trabajo al escritorio de otra persona. Los hallazgos se publican con correcciones o no se publican.

Licencia

MIT