mcpField
R
ruTS-mcp

ruTS-mcp

Local
sergeyshk.github.ioData & Analytics0Updated 4d ago
RepositoryVisit website

About ruTS-mcp

ruTS-mcp exposes Russian-text analysis from the ruTS library to LLM agents. It returns statistical measures with interpretation and caveats, alongside tools for examining words, collocations, and differences between texts.

Key features

  1. 01Grouped text statistics
  2. 02Readability and reader-age estimates
  3. 03Word and collocation analysis
  4. 04Text dispersion and keyness
  5. 05Style comparison across texts

Use cases

  1. 01Assessing readability of Russian text
  2. 02Finding word occurrences with context
  3. 03Comparing style across text collections

MCP support

The MCP server exposes ruTS analysis tools, resources, and prompts to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "sergeyshk-ruts": {
      "command": "uvx",
      "args": [
        "ruts-mcp"
      ]
    }
  }
}
Run commanduvx ruts-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiruts-mcp0.1.4

Tools

6

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
pathanyNoAbsolute path to a UTF-8 text file on the machine running the server, instead of text: long text need not be passed in the argument
textstringNoText in Russian; path can be specified instead
groupsarrayNoStatistics groups; each is a result key
descriptionsbooleanNoAdd descriptions to statistics; false gives a shorter response when descriptions are already known from a previous call
distributionsbooleanNoAdd distributions of words by number of letters and syllables, and punctuation marks by type (basic group)
readability_presetenumNoFlesch-Kincaid test coefficients (academic also includes the Flesch index), readability group: plainrussian is calibrated to school grades and is suitable for any text, including fiction; fiction uses Oborneva's coefficients based on literary texts and gives a grade several years higher; academic uses Solovyova, Ivanova, and Solnyshkina's coefficients based on textbooks for grades 5–11. Leave plainrussian unless there is a specific reason not to.plainrussian | fiction | academic

Details

From the project README

ruTS-mcp

ruTS-mcp

MCP-сервер для ruTS - статистики русского текста как инструменты для LLM-агентов

Документация · PyPI · English

Версия Поддерживаемые версии Python Сборка Ruff Лицензия Оценка Glama

ruTS-mcp дает LLM-агенту инструменты библиотеки ruTS, чтобы измерить русский текст, а не оценивать его на глаз. Каждое значение приходит вместе с описанием, прочтением по шкале, если она есть, и предупреждениями, когда значение неустойчиво или не имеет смысла для текста.

  • analyze_text - статистики текста по группам: базовые, удобочитаемость с классом и возрастом читателя, лексическое разнообразие, морфология, фоностатистики, связность, стиль и канцелярит, лексическая сложность, стих, синтаксис
  • kwic - вхождения слова или словосочетания с контекстом
  • collocations - устойчивые сочетания и сочетаемость слова
  • dispersion - насколько равномерно слова распределены по тексту
  • keyness - ключевые слова относительно русского языка или другого текста
  • compare_texts - чем различаются два корпуса текстов по признакам стиля
  • Ресурсы и промпты - шкалы удобочитаемости и нормы стиля, готовые разборы: удобочитаемость, канцелярит, стихотворение, SEO-проверка, сравнение двух текстов

Установка

Сервер запускается через uvx из uv, который сам скачает пакет и Python. Подключение к Claude Code:

claude mcp add ruts -- uvx ruts-mcp

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

uvx ruts-mcp download

Сервер вместе со скиллом, который подсказывает агенту, как им пользоваться, ставит плагин Claude Code:

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

Подключение к Claude Desktop, Cursor и другим клиентам и настройки - в документации.

Лицензия

MIT. Словари, которые скачивает ruts-mcp download, распространяются на условиях их авторов: частотный словарь Ляшевской и Шарова, словарь ударений Козиева (CC0), модель spaCy (MIT).

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.