readability-mcp-server

Un servidor MCP que permite a cualquier agente de IA comprobar y mejorar la calidad en lenguaje claro de su propio texto — antes de que ese texto llegue a un humano. Totalmente local: sin clave de API, sin llamadas de red, sin servicio externo. Es una herramienta puramente computacional, así que nada de lo que pases a través de ella sale jamás de la máquina en la que se ejecuta.

A diferencia de las demás herramientas de esta serie (scamlens, clearread, clauselens), esta no es un sitio web que se abre con un navegador: es infraestructura para el propio ecosistema de agentes de IA. Cualquier cliente compatible con MCP (Claude Code, Claude Desktop o cualquier otro) puede invocarla directamente.

Por qué

Los agentes generan mucho texto — respuestas, documentación, avisos, mensajes de error — y casi nunca tienen forma de comprobar si ese texto es realmente fácil de leer para el destinatario antes de enviarlo. Este servidor ofrece a cualquier agente esa autocomprobación como una llamada de herramienta de primera clase, mediante el mismo motor de lenguaje claro (división de frases + un diccionario revisado de palabras complejas a palabras simples) ya incluido y probado en clearread, la aplicación web independiente de esta serie — aquí expuesto para uso programático en lugar de para pegar el texto a mano en un navegador.

Related MCP server: BeLikeNative Grammar Server

Herramientas

readability_score_text

Calcula Flesch Reading Ease y Flesch-Kincaid Grade Level para un bloque de texto en inglés. Devuelve supported: false con solo los recuentos estructurales para texto no latino, ya que las fórmulas de Flesch asumen patrones de saplicación del inglés.

readability_simplify_text

Reescribe el texto en un lenguaje más llano —divide frases excesivamente largas en límites naturales de cláusula y sustituye el vocabulario burocrático habitual por equivalentes más claros— e informa de la puntuación Flesch Reading Ease antesrencia, para que puedas confirmar la reescritura realmente ayudó. Solo inglés, por diseño: la sustitución de palabras no es fiable en idiomas con una morfología más rica, así que el texto en escritura no latina se detecta y se deja sin cambios en lugar de arriesgar una gramática incorrecta (véase la nota del proyecto correspondiente src/services/simplify.ts sobre por qué unas pocas entradas traducidas alic, como "accompanied" → "went with", se retiraron porque quebraban frases hechas habituales como "must be accompanied by").

Instalación y configuración

Clona y compila:

git clone https://github.com/wedo911/readability-mcp-server.git
cd readability-mcp-server
npm install
npm run build

Añádelo a la configuración de tu cliente MCP (por ejemplo, claude_desktop_config.json, o el .mcp.json de un proyecto para Claude Code):

{
  "mcpServers": {
    "readability": {
      "command": "node",
      "args": ["/absolute/path/to/readability-mcp-server/dist/index.js"]
    }
  }
}

Ejecuta las pruebas

npm run build
node --test tests/textStats.test.mjs tests/simplify.test.mjs

Pruébalo sin un cliente

El MCP Inspector puede invocar herramientas por command directamentedesde la línea de comandos:

npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name readability_simplify_text \
  --tool-arg text="Please utilize the enclosed form prior to the deadline."

Licencia

MIT — consulta LICENSE.