Skip to main content
Glama
README.md
<p align="center">
  <img src="https://raw.githubusercontent.com/SergeyShk/ruTS-mcp/master/docs/img/ruts-mcp.png" alt="ruTS-mcp" width="480">
</p>

<h1 align="center">ruTS-mcp</h1>

<p align="center">
  <b>MCP-сервер для <a href="https://github.com/SergeyShk/ruTS">ruTS</a></b> - статистики русского текста как инструменты для LLM-агентов
</p>

<p align="center">
  <a href="https://sergeyshk.github.io/ruTS-mcp/">Документация</a> ·
  <a href="https://pypi.org/project/ruts-mcp/">PyPI</a> ·
  <a href="https://github.com/SergeyShk/ruTS-mcp/blob/master/README.en.md">English</a>
</p>

<p align="center">
  <a href="https://pypi.org/project/ruts-mcp/"><img src="https://img.shields.io/pypi/v/ruts-mcp?logo=pypi&logoColor=FFE873" alt="Версия"></a>
  <a href="https://pypi.org/project/ruts-mcp/"><img src="https://img.shields.io/pypi/pyversions/ruts-mcp.svg?logo=python&logoColor=FFE873" alt="Поддерживаемые версии Python"></a>
  <a href="https://github.com/SergeyShk/ruTS-mcp/actions/workflows/ci.yml"><img src="https://github.com/SergeyShk/ruTS-mcp/actions/workflows/ci.yml/badge.svg" alt="Сборка"></a>
  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
  <a href="https://github.com/SergeyShk/ruTS-mcp/blob/master/LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="Лицензия"></a>
  <a href="https://glama.ai/mcp/servers/SergeyShk/ruTS-mcp"><img src="https://glama.ai/mcp/servers/SergeyShk/ruTS-mcp/badges/score.svg" alt="Оценка Glama"></a>
</p>

---

**ruTS-mcp** дает LLM-агенту инструменты библиотеки [ruTS](https://github.com/SergeyShk/ruTS), чтобы измерить русский текст, а не оценивать его на глаз. Каждое значение приходит вместе с описанием, прочтением по шкале, если она есть, и предупреждениями, когда значение неустойчиво или не имеет смысла для текста.

* **[`analyze_text`](https://sergeyshk.github.io/ruTS-mcp/tools/analyze_text/)** - статистики текста по группам: базовые, удобочитаемость с классом и возрастом читателя, лексическое разнообразие, морфология, фоностатистики, связность, стиль и канцелярит, лексическая сложность, стих, синтаксис
* **[`kwic`](https://sergeyshk.github.io/ruTS-mcp/tools/kwic/)** - вхождения слова или словосочетания с контекстом
* **[`collocations`](https://sergeyshk.github.io/ruTS-mcp/tools/collocations/)** - устойчивые сочетания и сочетаемость слова
* **[`dispersion`](https://sergeyshk.github.io/ruTS-mcp/tools/dispersion/)** - насколько равномерно слова распределены по тексту
* **[`keyness`](https://sergeyshk.github.io/ruTS-mcp/tools/keyness/)** - ключевые слова относительно русского языка или другого текста
* **[`compare_texts`](https://sergeyshk.github.io/ruTS-mcp/tools/compare_texts/)** - чем различаются два корпуса текстов по признакам стиля
* **[Ресурсы и промпты](https://sergeyshk.github.io/ruTS-mcp/resources/)** - шкалы удобочитаемости и нормы стиля, готовые разборы: удобочитаемость, канцелярит, стихотворение, SEO-проверка, сравнение двух текстов

## Установка

Сервер запускается через `uvx` из [uv](https://docs.astral.sh/uv/getting-started/installation/), который сам скачает пакет и Python. Подключение к Claude Code:

```bash
claude mcp add ruts -- uvx ruts-mcp
```

Для групп `lexical`, `verse` и `syntax` нужны словари и модель spaCy, их скачивает одна команда:

```bash
uvx ruts-mcp download
```

Сервер вместе со [скиллом](https://sergeyshk.github.io/ruTS-mcp/installation/#skill), который подсказывает агенту, как им пользоваться, ставит плагин Claude Code:

```
/plugin marketplace add SergeyShk/ruTS-mcp
/plugin install ruts@ruts-mcp
```

Подключение к Claude Desktop, Cursor и другим клиентам и настройки - в [документации](https://sergeyshk.github.io/ruTS-mcp/installation/).

## Лицензия

[MIT](https://github.com/SergeyShk/ruTS-mcp/blob/master/LICENSE.txt). Словари, которые скачивает `ruts-mcp download`, распространяются на условиях их авторов: [частотный словарь](http://dict.ruslang.ru/freq.php) Ляшевской и Шарова, [словарь ударений](https://github.com/Koziev/NLP_Datasets) Козиева (CC0), [модель spaCy](https://github.com/explosion/spacy-models) (MIT).

<!-- mcp-name: io.github.SergeyShk/ruts-mcp -->

TDQS

A4/5.0

Scored across 6 tools

Disambiguation4/5

The six tools have largely distinct purposes: broad statistical analysis, keyword comparison, collocation extraction, corpus comparison, dispersion, and concordance. The main risk is conceptual overlap between analyze_text's lexical/cohesion groups and the specialized keyness/dispersion tools, but the descriptions clarify the boundaries well enough.

Naming Consistency3/5

Two tools use a clear verb_noun pattern (analyze_text, compare_texts), while the rest are noun-like names or an acronym (keyness, collocations, dispersion, kwic). The names are readable and memorable, but the set mixes conventions rather than following one predictable pattern.

Tool Count5/5

Six tools is well within the appropriate range for a Russian text-statistics server, and each tool covers a distinct analysis mode. analyze_text is broad but acts as a single umbrella for related statistical groups rather than inflating the tool count.

Completeness4/5

The set covers the core domain well: aggregate statistics, keywords, collocations, dispersion, concordance, and corpus comparison. A minor gap is that required dictionaries/models are referenced through an external download command rather than an exposed tool, which could create a dead end for agents without shell access.

Maintenance

ActivityActive
ResponsivenessNo recent community issues