readability-mcp-server

Сервер MCP, который позволяет любому ИИ-агенту проверять и улучшать простоту языка своего текста — до того, как этот текст попадёт к человеку. Полностью локально: не нужен API-ключ, не требуется сетевой вызов, нет внешнего сервиса. Это чисто вычислительный инструмент, поэтому всё, что вы через него пропускаете, никогда не покидает машину, на которой он запущен.

В отличие от других инструментов этой серии (scamlens, clearread, clauselens), это не сайт, который открывает человек, — это инфраструктура для самой экосистемы ИИ-агентов. Любой MCP-совместимый клиент (Claude Code, Claude Desktop или любой другой) может вызывать его напрямую.

Зачем

Агенты генерируют много текста — ответы, документацию, уведомления, сообщения об ошибках — и в большинстве случаев не имеют возможности проверить, действительно ли этот текст легко читается получателем, прежде чем отправить его. Этот сервер даёт каждому агенту такую самопроверку как полноценный вызов инструмента, используя тот же механизм простого языка (разбиение предложения + выверенный словарь замены сложных слов на простые), который уже включён и проверен в clearread — автономном веб-приложении из этой серии. Здесь он доступен для программного использования вместо ручной вставки в браузер.

Related MCP server: BeLikeNative Grammar Server

Инструменты

readability_score_text

Вычисляет Flesch Reading Ease и Flesch open Flesch-Kincaid Grade Level для блока английского текста. Для нелатинской письменности возвращает supported: false и только структурные счётчики, поскольку формулы Flesch предполагают английские слоговые модели.

readability_simplify_text

Переписывает текст более простым языком: разбивает слишком длинные предложения на естественные границы придаточных и заменяет распространённую бюрократическую лексику на более простые эквиваленты. Сообщает оценку Flesch Reading Ease до и после, чтобы вы могли убедиться, что переписывание действительно помогло. Только английский текст — это осознанное проектное решение: подстановка слов ненадёжна в языках с богатой морфологией, поэтому нелатинский текст обнаруживается и передаётся без изменений, чтобы не рисковать поломкой грамматики. См. также после примечание в src/services/simplify.ts, почему несколько заманчивых словарных статей, например «accompanied» → «went with», были исключены после того, как они нарушили устойчивые фразы типа «must be accompanied by».

Установить и настройка

Склонируйте и соберите:

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

Добавьте его в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json или под проектируемого . mcp.json для Claude Code):

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

Запуск тестов

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

Попробуйте без клиента

MCP Inspector может вызывать инструменты прямо из командной строки:

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

License

MIT — см. LICENSE.