Ctxo MCP
Ctxo строит граф зависимостей репозитория и дает агенту через MCP зону поражения изменения, историю коммитов и состояние кода
- 74 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ставит git-хуки и хук PreToolUse в `.claude/settings.json` и правит `CLAUDE.md` и настройки клиента
- Читает весь репозиторий и историю git, индекс лежит в каталоге `.ctxo/`
Установка
- Работает в
Ручная установка
npm install -g @ctxo/cliДает команду ctxo. Затем в корне репозитория выполните ctxo init и ctxo index.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ставит git-хуки и хук PreToolUse в `.claude/settings.json` и правит `CLAUDE.md` и настройки клиента
- Читает весь репозиторий и историю git, индекс лежит в каталоге `.ctxo/`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ctxo один раз индексирует репозиторий и держит индекс свежим через наблюдателей файлов и git-хуки. В детерминированный граф попадают символы, связи импортов, вызовов, наследования и реализации, чтение, запись и выполнение данных, а также коммиты с классифицированным намерением. Агент получает все это через 14 семантических инструментов MCP, а пакет `@ctxo/domain` добавляет еще четыре. Вместо череды поисков по тексту хватает одного вызова. `get_blast_radius` показывает, что сломается при правке символа, `get_pr_impact` заменяет ревью вопроса «что это вызывает», `get_why_context` объясняет, почему код выглядит так, по истории коммитов. Сервер ранжирует контекст под задачу командами `get_context_for_task` и `get_ranked_context`. Команда `ctxo init` определяет языки, ставит плагины, подключает Ctxo к клиенту ИИ, ставит git-хуки и строит первый индекс. В Claude Code она регистрирует хук PreToolUse, который блокирует первую правку символа с большой зоной поражения, пока агент не вызвал `get_blast_radius`, и ставит скиллы `ctxo-understand`, `ctxo-safe-edit` и `ctxo-review-pr`. Поддерживаются TypeScript и JavaScript, Go, C#, Java и T-SQL.
Для кого. Разработчикам, которые отдают агенту большой репозиторий и хотят, чтобы он видел зависимости и историю до правки: сломанная сборка потом уже ни к чему.
Подходит, если
- Перед переименованием функции нужно знать всех импортеров и наследников, которые поиском по тексту не находятся
- Агент правит символ, от которого зависит много кода, и его нужно остановить, пока он не проверил зону поражения
- Нужно понять, почему код написан так, и не повторить баг, откатанный три недели назад
- Перед ревью pull request надо оценить влияние диффа на остальной код одним вызовом
Не подходит, если
- Репозиторий на языке вне списка: сейчас поддержаны TypeScript и JavaScript, Go, C#, Java и T-SQL
- Проект крошечный, и агенту хватает чтения нескольких файлов
- Нужен только поиск строки по коду: для этого хватит `grep`
Пример запроса к агенту
Поставь Ctxo, проиндексируй репозиторий и покажи зону поражения функции buildGraph перед тем, как ее менятьMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Хук-блокировщик правок есть только в Claude Code. Cursor получает скиллы и правила без блокировки, прочие клиенты только правила.
- Полный уровень разбора есть не у всех языков: Java требует JRE 11 или новее, C# нужен .NET SDK 8 или новее, иначе работает уровень синтаксиса на tree-sitter.
- Индекс обновляется git-хуком после коммита, правки вне коммита видны после ручного `ctxo index`.
- Команда `ctxo init` меняет `CLAUDE.md` и файлы настройки клиента, а при повторном запуске заменяет свой блок на месте.
Как отключить. Для отключения блокировки запустите `ctxo init --no-guard` или установите `gate.enabled: false` в `.ctxo/config.yaml`. Команда `ctxo doctor --fix` чинит блок, скиллы и хук, если они разошлись. Полностью утилиту снимает npm uninstall -g @ctxo/cli, каталог `.ctxo/` и git-хук удаляются вручную.
Частые вопросы
Как поставить Ctxo для Claude Code?
Выполните `npm install -g @ctxo/cli`, затем в корне репозитория `ctxo init` и `ctxo index`. Первая команда сама определяет языки, подключает MCP, ставит хуки и скиллы.
Что такое зона поражения?
Это список символов и файлов, которые затронет правка выбранного символа: прямые и косвенные зависимые и те, что часто меняются вместе с ним. Ее выдает инструмент `get_blast_radius`.
Блокирует ли Ctxo правки агента?
В Claude Code да: хук PreToolUse останавливает первую правку символа с большой зоной поражения, пока агент не вызвал `get_blast_radius`. Срабатывает один раз на символ за сессию. Чувствительность задает `gate.sensitivity`.
Какие языки поддерживаются?
TypeScript и JavaScript, Go, C#, Java и T-SQL. Языки ставятся командой вида `ctxo install typescript go csharp`, для Java при наличии JRE 11 добавляется полный уровень.
Есть ли визуальный интерфейс?
Да. `ctxo visualize` собирает автономный HTML с графом зависимостей, а отдельная панель показывает дерево файлов, тепловую карту, связанные изменения, хронологию и архитектуру.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер в одном бинарнике: ИИ читает и правит файлы нескольких проектов и запускает ваши команды
Считает, какие файлы импортируют друг друга и что заденет правка, и отдает это агенту через хуки, MCP и команду codemap
Локальный MCP-сервер индексирует код проекта, и агент достает из индекса нужные функции вместо чтения целых файлов
CLI создает и проверяет документы-правила для кодинг-агентов: PATTERNS.md, CLAUDE.md и ARCHITECTURE.md, плюс ловит устаревание.
Codex MCP Tool (cexll)
Codex MCP Tool
MCP-сервер передает задачи Codex CLI из Claude Code и Cursor: разбор кода по ссылкам @, песочница, правки патчем, идеи
Плагин Claude Code ведет задачу через стадии с ревью и воротами, а локальная доска показывает решения и ход выполнения.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ctxo (эта карточка) | нет | не нужна | 74 | |
| CodeGraph | нет | не нужна | 77 481 | граф кода без хука блокировки правок и без анализа истории коммитов |
| Serena | нет | не нужна | 31 335 | навигация по символам через языковые серверы, без графа с историей git |
| code-review-graph | нет | не нужна | 32 733 | граф для ревью изменений, блокировки правок агента нет |
Коротко о README
README начинается с команд установки и описывает проблему слепого кодинга: агент ищет символ поиском, читает файлы, пропускает наследников и не смотрит историю. Дальше рассказано про индекс графа, 14 инструментов MCP, панель с восемью видами, граф зависимостей и защиту безопасной правки с хуком и тремя скиллами. Отдельные разделы объясняют обновление индекса на каждый коммит, список поддерживаемых языков и настройку чувствительности блокировки.