readability-mcp-server

Ein MCP-Server, der jedem KI-Agenten ermöglicht, die Qualität seines eigenen Texts in einfacher Sprache zu prüfen und zu verbessern – bevor dieser Text je einen Menschen erreicht. Vollständig lokal: kein API-Schlüssel, kein Netzwerkaufruf, kein externer Dienst. Er ist ein reines Berechnungswerkzeug, sodass nichts, was du durchschickst, den Rechner verlässt, auf dem er läuft.

Im Gegensatz zu den anderen Werkzeugen dieser Reihe (scamlens, clearread, clauselens) ist dieser Server keine Website, die eine Person öffnet – er ist Infrastruktur für das KI-Agenten-Ökosystem selbst. Jeder MCP-kompatible Client (Claude Code, Claude Desktop oder irgendein anderer) kann ihn direkt aufrufen.

Warum

Agenten erzeugen viel Text – Antworten, Dokumentationen, Hinweise, Fehlermeldungen – und haben meist keine Möglichkeit zu prüfen, ob dieser Text für den Empfänger wirklich leicht zu lesen ist, bevor sie ihn senden. Dieser Server gibt dem Agenten genau diese Selbstprüfung als erstklassigen Tool-Aufruf an die Hand. Er nutzt dieselbe Engine für einfache Sprache (Satzentteilung plus geprüftes Wörterbuch für komplexe-zu-einfache Wörter), die bereits in clearread, der eigenständigen Web-App dieser Reihe, ausgeliefert und getestet wurde – hier für die programmatische Nutzung bereitgestellt, statt den Text von Hand in einen Browser einzufügen.

Related MCP server: BeLikeNative Grammar Server

Werkzeuge

readability_score_text

Berechnet den Flesch-Reading-Ease-Wert und die Flesch-Kincaid Grade Level für einen Block englischen Texts. Für nichtlateinische Schriften liefert es nur supported: false mit strukturellen Zählern, da die Flesch-Formeln auf englische Silbenmuster ausgelegt sind.

readability_simplify_text

Schreibt Text in einfacherer Sprache um – zerlegt übermäßig lange Sätze an natürlichen Satzgrenzen und ersetzt gängiges bürokratisches Vokabular durch einfachere Entsprechungen – und gibt den Flesch-Reading-Ease-Score vorher und nachher aus, damit du bestätigen kannst, dass die Umformulierung wirklich geholfen hat. Bewusst nur Englisch: Die Wortersetzung ist bei Sprachen mit reicherer Morphologie unzuverlässig, daher wird nicht-lateinische Schrift erkannt und unverändert durchgereicht, statt fehlerhafte Grammatik zu riskieren (siehe den Hinweis in src/services/simplify.ts, warum einige verlockende Wörterbucheinträge wie „accompanied“ → „went with“ weggelassen wurden, weil sie gängige feste Wendungen wie „must be accompanied by“ aufgebrochen haben).

Installieren und konfigurieren

Klonen und bauen:

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

Füge es der Konfiguration deines MCP-Clients hinzu (z. B. claude_desktop_config.json oder die .mcp.json eines Projekts für Claude Code):

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

Tests ausführen

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

Ohne einen Client ausprobieren

Der MCP Inspector kann Werkzeuge direkt aus der Befehlszeile aufrufen:

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

Lizenz

MIT – siehe LICENSE.