codesight MCP
codesight за один запуск собирает карту проекта: маршруты, модели БД, зависимости, env-переменные. Отдает ее агенту файлами или через MCP-сервер
- 1 420 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сканирует весь проект и перечисляет env-переменные с файлами, где они упоминаются, а карту сохраняет в .codesight/ внутри репозитория
- Команды --init, --profile и --hook создают файлы инструкций для агентов и ставят хук git, который запускает codesight при каждом коммите
- Плагин Terraform по явной настройке читает соседние папки за пределами проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/codesightОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сканирует весь проект и перечисляет env-переменные с файлами, где они упоминаются, а карту сохраняет в .codesight/ внутри репозитория
- Команды --init, --profile и --hook создают файлы инструкций для агентов и ставят хук git, который запускает codesight при каждом коммите
- Плагин Terraform по явной настройке читает соседние папки за пределами проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
codesight запускается командой `npx codesight` в корне проекта и за доли секунды строит карту кода. Восемь детекторов работают параллельно: маршруты API (больше 30 фреймворков), модели и связи баз данных (14 ORM), компоненты интерфейса, граф импортов, промежуточные обработчики, конфигурация с env-переменными, экспорты библиотек и контракты. Для TypeScript разбор идет через AST компилятора, остальные языки (Python, Go, Ruby, Java, Rust, PHP и другие) разбираются регулярными выражениями. Результат лежит в папке `.codesight/`: общий файл `CODESIGHT.md` и отдельные `routes.md`, `schema.md`, `components.md`, `libs.md`, `config.md`, `middleware.md`, `graph.md`. Встроенные плагины читают еще пайплайны GitHub Actions и CircleCI, хуки git и скиллы из `.claude/`. Дальше карту можно отдать агенту несколькими способами. `npx codesight --init` создает `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, `codex.md` и `AGENTS.md` с описанием стека и самых зависимых файлов. `--profile` пишет файл под один инструмент, `--wiki` раскладывает карту на короткие статьи в `.codesight/wiki/`, чтобы агент читал оглавление в 200 токенов и нужную статью, а не весь файл. Команда `--blast src/lib/db.ts` обходит граф импортов в ширину и показывает, какие файлы, маршруты и модели заденет правка. Команда `npx codesight --mcp` запускает MCP-сервер из 14 инструментов: сводка, маршруты с фильтром по префиксу и методу, схема по имени модели, радиус влияния, самые импортируемые файлы, события фоновых очередей, карта покрытия тестами, статьи вики. Первый вызов сканирует проект, остальные берут результат из кэша сессии. Режим `--mode knowledge` строит такую же карту для папки с заметками в Markdown: решения, открытые вопросы, протоколы встреч. Ключ `--watch` пересобирает карту при изменении кода, а `--hook` ставит git-хук, который обновляет ее при каждом коммите.
Для кого. Для разработчиков, которые работают с Claude Code, Cursor, Codex или Copilot над проектами на TypeScript, Python, Go и других языках и устали тратить окно контекста на то, чтобы агент заново изучал маршруты и схему БД.
Подходит, если
- Агент в начале каждой сессии долго читает файлы, чтобы понять, какие в проекте маршруты API и таблицы БД
- Перед правкой общего модуля надо узнать, какие файлы, маршруты и модели от него зависят
- Нужно сразу получить файлы инструкций для Claude Code, Cursor, Codex и Copilot с описанием стека
- Папка заметок в Obsidian или каталог ADR должны превратиться в короткую карту решений и открытых вопросов для агента
- Проверка проекта по env-переменным: какие обязательны, в каком файле используются
Не подходит, если
- Нужна упаковка репозитория целиком в один файл с текстом кода: codesight выдает структуру, а не исходники, для сборки файла в каталоге есть Repomix
- Нужен граф вызовов функций и символов на основе `tree-sitter`: codesight строит карту маршрутов, моделей и импортов между файлами, а не вызовов внутри функций
- Установлен Node.js старше 18-й версии: пакет требует Node.js 18 или новее
- Проект на языке и фреймворке, которых нет в списке детекторов: для таких файлов карта будет неполной без собственного плагина
Пример запроса к агенту
Подключи codesight к этому проекту и скажи, какие маршруты и файлы заденет изменение в src/lib/db.tsMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Лицензия MIT. Полный разбор через AST работает только для TypeScript, остальные языки разбираются регулярными выражениями, поэтому карта маршрутов и моделей там может пропускать нестандартные случаи.
- Цифры экономии токенов в описании проекта автор считает сам: токены вывода измеряет по размеру файла, а затраты на ручное изучение оценивает по числу найденных маршрутов, моделей и компонентов, поэтому в вашем проекте результат будет другим.
- Если нужна полная точность для Rust, Python и Go, включите ключ `--native-ast`: WASM-плагины не входят в npm-пакет, их скачивают отдельно из релизов GitHub и кладут в `~/.codesight/plugins/`.
- Плагин Terraform выключен по умолчанию, потому что намеренно читает папки за пределами проекта, например соседний репозиторий `../infrastructure`.
- Команда `--init` создает файлы инструкций для пяти инструментов за раз, а `--hook` добавляет хук в git, поэтому сверьте изменения в `git status`, прежде чем коммитить результат.
Как отключить. Удалите из настроек агента запись MCP-сервера codesight и папку `.codesight/` в проекте. Файлы `CLAUDE.md`, `.cursorrules`, `codex.md` и `AGENTS.md`, если вы запускали `--init`, удаляются вручную. Хук git снимите, удалив строку codesight из `.git/hooks/pre-commit`. Отдельные детекторы выключает `disableDetectors` в `codesight.config.js`.
Частые вопросы
Нужны ли ключи API или аккаунт?
Нет. Автор описывает запуск одной командой без настройки и ключей, вики строится из AST без обращений к языковым моделям. Сеть нужна лишь для скачивания: первый запуск через `npx` берет пакет из npm, плагины для `--native-ast` скачивают вручную из релизов GitHub.
Что такое радиус влияния и как его получить?
Это список файлов, маршрутов, моделей и обработчиков, которые косвенно зависят от выбранного файла. Команда `npx codesight --blast src/db/index.ts` обходит граф импортов в ширину на глубину до трех шагов. Агент получает тот же результат через MCP-инструмент `codesight_get_blast_radius` до начала правки.
Чем вики отличается от обычной карты?
Карта `CODESIGHT.md` занимает от трех до пяти тысяч токенов и загружается целиком. Вики из `--wiki` раскладывает ее по темам: оглавление `index.md` около 200 токенов, дальше статьи про авторизацию, платежи, базу данных, пользователей и интерфейс. Агент читает оглавление и одну нужную статью. Журнал `log.md` хранит записи обо всех операциях.
Как подключить сервер к Codex, если он не успевает стартовать?
При первом запуске `npx` скачивает пакет, и это может занять больше 30 секунд, которые Codex отводит по умолчанию. В `~/.codex/config.toml` в разделе `[mcp_servers.codesight]` добавьте `startup_timeout_sec = 60` или установите пакет глобально командой `npm install -g codesight` и укажите `command = "codesight"`.
Можно ли разобрать заметки, а не код?
Да, для этого есть режим `--mode knowledge`. Он читает файлы Markdown из текущей папки, хранилища Obsidian или папки docs и узнает записи решений в формате ADR, протоколы встреч, ретроспективы, спецификации и исследования. Результат попадает в `.codesight/KNOWLEDGE.md` и доступен агенту через инструмент `codesight_get_knowledge`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
Локальный граф структуры кода: строит карту репозитория через tree-sitter и отдает агенту по MCP только тот контекст, который относится к правке
MCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу
Одиннадцать скиллов для Claude Code и Codex: аудит тестов, очистка git worktree, страницы планов, расшифровка записей экрана и вход через 1Password
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
MCP-сервер и CLI на Go: агент ведет в репозитории индекс кода и схемы базы, хранит его в Git и читает целиком перед каждой задачей
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| codesight (эта запись) | нет | не нужна | 1 420 | |
| Repomix | нет | не нужна | 28 983 | упаковывает репозиторий целиком в один файл с кодом, а не в карту маршрутов и моделей |
| code-review-graph | нет | не нужна | 32 333 | локальный граф структуры кода на tree-sitter, отдает агенту по MCP только контекст, относящийся к правке |
| CodeGraph | нет | не нужна | 74 886 | граф символов и связей, точки входа и радиус влияния изменений за один вызов |
Коротко о README
В репозитории есть описание команд и всех ключей, примеры вывода для маршрутов, схемы, радиуса влияния и аудита env-переменных, сравнение токенов до и после на реальных проектах, список поддерживаемых стеков с отдельным разделом про Roku и BrightScript. Рядом лежат документ про WASM-плагины, набор эталонных проектов для проверки точности с ожидаемыми результатами в папке `eval`, 149 тестов и готовый сценарий для GitHub Actions. Самого пакета на странице нет, он ставится из npm.