Qartez MCP

Установка

Работает в

• Claude Code
• Claude Desktop
• Cursor
• Codex
• Gemini CLI
• Windsurf
• Cline
• Roo Code
• OpenCode
• Goose
• Amp
• SourceCraft
• Koda
• Coddy

Ручная установка

curl -sSfL https://qartez.dev/install | sh

Что делает

Qartez один раз строит индекс репозитория и отдает его агенту через MCP. В графе лежат символы, импорты, ребра вызовов, радиус поражения изменений, PageRank файлов, совместные изменения в git, цикломатическая сложность, структурные клоны через хеши AST и нарушения границ архитектуры. Агент запрашивает индекс и не перечитывает файлы при каждом вопросе. Индексация запускается сама в начале сессии, а наблюдатель за файлами держит индекс свежим. Основной набор из восьми инструментов доступен всегда: `qartez_map` строит карту проекта по важности, `qartez_find` и `qartez_grep` ищут символы, `qartez_read` читает исходник символа без чтения файла, `qartez_outline` выдает оглавление файла, `qartez_impact` показывает прямых и транзитивных зависимых перед правкой, `qartez_deps` и `qartez_stats` дают граф зависимостей и сводку. Дополнительные уровни, например analysis, включаются вызовом `qartez_tools`: `qartez_refs`, `qartez_calls`, `qartez_cochange`, `qartez_diff_impact` для диапазона вроде `main..HEAD`, `qartez_hotspots` для самых опасных для рефакторинга мест и `qartez_unused` для мертвого кода. Всего инструментов 43. Автор сопоставляет вызовы: определение символа находится за 52 токена вместо 1490 при обходе grep, оценка влияния правки за 352 токена вместо 9243, а общий расход токенов снижается примерно на 94 процента. Это замеры самого проекта, перепроверьте их на своем коде. Вместе ставится `qartez-guard`, хуки Claude Code для защиты изменений, и `qartez-setup`, который настраивает все найденные IDE.

Для кого. Разработчикам на больших кодовых базах, которые работают с Claude Code, Cursor, Codex и другими MCP-клиентами и хотят экономить токены и видеть последствия правок.

Пример запроса к агенту

Покажи через qartez_impact, что сломается, если я изменю storage/read.rs, и перечисли файлы, которые меняются вместе с ним.

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

Поддерживаются macOS 13 и новее, Ubuntu 22.04 и новее с другими современными дистрибутивами Linux, Windows с PowerShell 5.1 или 7 и WSL 2, архитектуры x86_64 и arm64. Для платформ без готового бинарного файла установщик собирает проект локально, для этого нужен Rust 1.90 или новее.

Установка через `curl -sSfL https://qartez.dev/install | sh` скачивает бинарные файлы, проверяет SHA-256, ставит три программы (`qartez`, `qartez-guard`, `qartez-setup`) и настраивает все найденные IDE, делая копию их конфигов. Лицензия двойная: смотрите LICENSE и COMMERCIAL.md. Показатели экономии токенов получены самим автором.

Как отключить. Выполните `make uninstall` в клонированном репозитории: команда убирает Qartez из конфигов всех IDE и удаляет бинарные файлы. Для ручной настройки удалите блок qartez из `mcpServers` вашего клиента.

Коротко о README

Описание начинается с тезиса, что grep и cat придуманы для людей, а агенту нужен заранее посчитанный граф кода. Дальше идут установка, перечень из 43 инструментов по уровням, примеры экономии токенов, защита изменений, поддерживаемые языки и сравнения.