SDL-MCP

Установка

Работает в

• Claude Code
• Codex
• Gemini CLI
• OpenCode
• SourceCraft
• Koda
• Coddy

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

npm install -g sdl-mcp

Что делает

SDL-MCP (Symbol Delta Ledger) разбирает репозиторий на символы и связи между ними и работает с этим графом локально. Агент не открывает файлы целиком. Он ищет символ, смотрит его карточку с сигнатурой, кратким описанием и связями, а исходный код запрашивает только когда карточки не хватило. Для больших задач сервер собирает срез графа: по описанию задачи или по стартовому символу он возвращает подграф с ограничением по размеру, который можно обновить или расширить. Запросы идут от простого к подробному: сначала карточки и скелеты функций, затем более детальные представления и в конце окна исходного кода. Окна с кодом сервер выдает по настроенным политикам. Сервер умеет сравнивать проиндексированные версии, находить измененные символы и затронутые связи. Инструмент `sdl.pr.risk.analyze` собирает для ревью pull request доказательства изменений и рекомендации по тестам. Правки из несохраненного буфера редактора видны серверу раньше, чем файл записан на диск. Структуру кода сервер разбирает через tree-sitter, а для точных перекрестных ссылок может подключать данные SCIP и языковых провайдеров. Транспорт stdio подходит для одного агента, HTTP позволяет нескольким агентам делить сервер и открывает визуализатор графа и панель наблюдения. Набор инструментов настраивается: плоский набор из 38 инструментов, шлюз из 6 или компактный Code Mode из 7.

Для кого. Для разработчиков, которые запускают Claude Code, Codex, Gemini CLI или OpenCode на больших репозиториях и хотят тратить меньше токенов на чтение файлов.

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

Найди через SDL-MCP все места, где вызывается функция создания заказа, покажи карточки символов и объясни, какие тесты запускать после правки

MCP

Транспорт

stdio, http

Авторизация

не нужна

Ограничения

Нужен Node.js 24 или новее. Community License разрешает запускать, изменять и использовать SDL-MCP, в том числе внутри бизнеса. Исходный код открыт для чтения, но продавать, встраивать и распространять SDL-MCP в коммерческом продукте можно только по отдельной лицензии.

Если клиенту удобнее меньше вариантов, включите шлюз или Code Mode вместо плоского набора. Семантические эмбеддинги необязательны, при инициализации их можно отключить. Точность перекрестных ссылок зависит от того, есть ли для файла данные SCIP или языкового провайдера, иначе используется обычный разбор.

Политики выполнения задают допустимые исполняемые файлы, рабочие каталоги, окружение и таймауты, поэтому проверьте их до включения. Токен HTTP-сервера держите в секрете. Заметки разработки («memories») сохраняются, только если их включить.

Как отключить. Удалите сервер из конфигурации агента, а пакет командой `npm uninstall -g sdl-mcp`. Данные индекса лежат в каталогах, которые вы выбрали при `sdl-mcp init`, и удаляются вместе с ними. Общие ресурсы настройки хранятся в `~/.sdl-mcp`.

Коротко о README

Документация описывает цикл из трех шагов: индексация репозитория, поиск символов или сбор контекста под задачу и постепенное раскрытие деталей. Руководства по срезам графа, живой индексации, SCIP, политикам и панели наблюдения лежат в каталоге docs. Сгенерированный список инструментов показывает актуальный набор для текущей версии.