https://svacer.ispras.ru/mediawiki/api.php?action=feedcontributions&feedformat=atom&user=MitrofanovSvacer Wiki - User contributions [en]2026-07-09T22:04:53ZUser contributionsMediaWiki 1.40.1https://svacer.ispras.ru/mediawiki/index.php?title=Help:CLI/cleanup&diff=3576Help:CLI/cleanup2026-05-27T07:48:17Z<p>Mitrofanov: /* Параметры */</p>
<hr />
<div>= Автоматическое удаление снимков =<br />
<br />
== Обзор ==<br />
<br />
Удаление происходит по умолчанию раз в 24 часа (время можно задать при запуске сервера опцией <code>--snapshots-cleanup-period</code>, либо в конфигурационном файле опцией <code>snapshots-cleanup-period</code>, либо переменной окружения <code>SVACER_CLEANUP_SNAPSHOTS_PERIOD</code>, но не меньше 15 минут). Первое удаление всех подходящих снимков будет выполнено через указанное время после запуска сервера.<br />
<br />
'''Принцип работы:''' происходит проверка всех снимков на соответствие правилам удаления и правилам на запрет удаления, после этого происходит удаление самых старых по времени создания подходящих снимков и заносится отметка в таблицу удаленных снимков и в системный журнал. После этого происходит удаление пустых веток и проектов в соответствии с правилами удаления. Также информация об удалении через cleanup вносится в системный журнал.<br />
<br />
Данная функциональность доступна пользователям с доступом '''ServerOperations'''.<br />
<br />
== Добавление нового правила удаления ==<br />
<br />
svacer server cleanup add-rule --user <user> --password <password> --project <project> --branch <branch> --snapshot <snapshot> --keep-time <nowiki><time></nowiki> --min-snapshots <min> --cleanup-type <type><br />
<br />
=== Параметры ===<br />
<br />
* <code>--project</code> — проект, в котором искать снимки для удаления ('''обязательный''', используйте <code>"*"</code> для всех проектов)<br />
* <code>--branch</code> — ветка, в которой искать снимки для удаления ('''обязательный''', используйте <code>"*"</code> для всех веток)<br />
* <code>--snapshot</code> — снимок, который удалять ('''обязательный''', используйте <code>"*"</code> для всех снимков)<br />
* <code>--keep-time</code> — время, которое должно пройти после создания '''(НЕ импорта)''' снимка, чтобы его удалить. Задается в формате Go Duration (например, <code>33h5m</code>, <code>720h</code>). По умолчанию '''720 часов''' (30 дней).<br />
* <code>--min-snapshots</code> — количество снимков, которое необходимо оставлять в ветке, подходящей под паттерн project + branch. По умолчанию 0.<br />
* <code>--cleanup-type</code> — тип очистки. Возможные значения - project, branch, snapshot (по умолчанию snapshot). При указании snapshot будут очищаться снимки в соответствии с паттерном проект+ветка+снимок и проверяться <code>keep-time</code> и <code>min-snapshots</code>. При указании branch будут удаляться пустые ветки в соответствии с паттерном project + branch. При указании project Будут удаляться пустые проекты (у которых нет веток) в соответствии с паттерном project. При указании branch или project невозможно указать <code>keep-time</code> и <code>min-snapshots</code>, эти флаги не учитываются.<br />
<br />
<br />
Значения параметров <code>--project</code>, <code>--branch</code>, <code>--snapshot</code> можно задавать как:<br />
<br />
'''1. Название или UUID:'''<br />
--project "MyProject"<br />
--project "550e8400-e29b-41d4-a716-446655440000" # UUID проекта<br />
<br />
'''2. <code>*</code> (любое количество любых символов):'''<br />
--project "Dev*" # DevProject, Development<br />
--branch "*test*" # test, my-test, testing<br />
--snapshot "nightly-*"<br />
<br />
'''3. Регулярные выражения (с префиксом <code>re:</code>):'''<br />
--snapshot "re:^v[0-9]+\.[0-9]+\.[0-9]+$" # v1.0.0, v2.3.5<br />
--branch "re:^feature/[0-9]+$" # feature/123<br />
<br />
== Добавление запрета на удаление ==<br />
<br />
svacer server cleanup add-exclude-rule --user <user> --password <password> --project <project> --branch <branch> --snapshot <snapshot><br />
<br />
=== Параметры ===<br />
<br />
* <code>--project</code> — проект, в котором искать снимки для удаления ('''обязательный''' , используйте <code>"*"</code> для всех проектов)<br />
<br />
* <code>--branch</code> — ветка ('''обязательный''', используйте <code>"*"</code> для всех веток)<br />
* <code>--snapshot</code> — снимок ('''обязательный''', используйте <code>"*"</code> для всех снимков)<br />
Флаги проекта, ветки и снимка работают аналогично с флагами в <code>--add-rule</code>.<br />
<br />
== Удаление правила ==<br />
<br />
svacer server cleanup delete --user <user> --password <password> --id <config id><br />
<br />
Где:<br />
* <code>--id</code> — ID конфигурации из таблицы правил или запретов (получить через <code>cleanup list</code>)<br />
<br />
== Вывести таблицу ==<br />
<br />
svacer server cleanup list --user <user> --password <password> --type <rule|exclude-rule|log> --format <table|json><br />
<br />
Где:<br />
* <code>--type</code> — тип таблицы: <code>rule</code> — таблица правил удаления (по умолчанию); <code>exclude-rule</code> — таблица запретов на удаление; <code>log</code> — таблица удаленных снимков<br />
<br />
* <code>--format</code> — формат вывода: <code>table</code> — человекочитаемый вывод (по умолчанию); <code>json</code> — JSON формат<br />
== Запуск очистки вручную ==<br />
<br />
svacer server cleanup run --user <user> --password <password><br />
<br />
Запускает процесс очистки немедленно (вне расписания).<br />
<br />
== Примеры ==<br />
<br />
=== Добавление нового правила ===<br />
<br />
'''Удаление по времени'''<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "Devel*" --branch "2025" --snapshot "*" --keep-time 240h<br />
<br />
Удалятся снимки старше 240 часов (10 дней) в проектах, начинающихся с "Devel", в ветке "2025".<br />
<br />
'''Ограничение количества'''<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "*" --branch "main" --snapshot "*" --min-snapshots 20 --keep-time 12h<br />
<br />
В любом проекте в ветке "main" всегда будет не более 20 снимков; остальные снимки старше 12 часов будут удаляться.<br />
<br />
'''Очистка пустых веток'''<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "*" --branch "master" --cleanup-type branch<br />
<br />
В любом проекте ветка "master" будет удаляться, если в ней нет снимков.<br />
<br />
=== Добавление запрета на удаление ===<br />
<br />
svacer server cleanup add-exclude-rule --user admin --password admin --project "Devel*" --branch "2025" --snapshot "test*"<br />
<br />
Снимки, начинающиеся с "test", в проектах "Devel*" и ветке "2025" '''никогда не удаляются правилами cleanup'''.<br />
<br />
=== Вывод таблицы правил ===<br />
<br />
svacer server cleanup list --user admin --password admin --type rule<br />
[[File:Cleanup rules.png|none|thumb|955x955px]]<br />
<br />
=== Вывод таблицы запретов ===<br />
<br />
svacer server cleanup list --user admin --password admin --type exclude-rule<br />
[[File:Cleanup exclude rule table.png|none|thumb|1009x1009px]]<br />
<br />
=== Вывод в JSON формате ===<br />
<br />
svacer server cleanup list --user admin --password admin --type exclude-rule --format json<br />
<br />
Вывод:<br />
<br />
[{"Branch":"2025","CreatedBy":"admin","CreatedById":"00000000-0000-0000-0000-000000000000","ID":"018fe552-f390-4110-9545-6ef9cbe1a406","MinBranchSnapshots":0,"Project":"Devel*","Snapshot":"test*","create_time":"2025-10-13T15:00:14.997004Z"}]<br />
<br />
=== Удаление правила ===<br />
<br />
svacer server cleanup delete --user admin --password admin --id b1895877-1f3c-4b12-ac19-3ff4a7bc5416<br />
<br />
=== Использование regex ===<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "*" --branch "re:^feature/JIRA-[0-9]+$" --snapshot "*" --keep-time 168h<br />
<br />
Подходит: <code>feature/JIRA-123</code>, <code>feature/JIRA-456</code><br>Не подходит: <code>feature/JIRA-ABC</code>, <code>bugfix/JIRA-123</code><br />
<br />
=== Regex синтаксис ===<br />
<br />
{| class="wikitable"<br />
! Паттерн !! Описание !! Пример<br />
|-<br />
| <code>^</code> || Начало строки || <code>^test</code><br />
|-<br />
| <code>[^x]</code> || Отрицание символов || <code>^[^m].*$</code><br />
|-<br />
| <code>$</code> || Конец строки || <code>test$</code><br />
|-<br />
| <code>.</code> || Любой символ || <code>a.c</code> → abc, a1c<br />
|-<br />
| <code>.*</code> || Любое кол-во символов || <code>test.*</code> → test-123<br />
|-<br />
| <code>.+</code> || Один или более || <code>test.+</code> → test-1<br />
|-<br />
| <code>[0-9]</code> || Любая цифра || <code>v[0-9]</code> → v1, v9<br />
|-<br />
| <code>[a-z]</code> || Буква (нижний регистр) || <code>[a-z]+</code> → abc<br />
|-<br />
| <code>[A-Z]</code> || Буква (верхний регистр) || <code>[A-Z]+</code> → ABC<br />
|-<br />
| <code>(a&#124;b)</code> || "a" или "b" || <code>(test&#124;prod)</code><br />
|-<br />
| <code>[0-9]{2,4}</code> || От 2 до 4 цифр || <code>12</code>, <code>1234</code><br />
|}<br />
Не поддерживается '''negative lookahead''' <code>(?!...)</code>. Используйте комбинацию правил и запретов.<br />
<br />
Для правил отрицания конкретного элемента возможно использовать сложные правила, например:<br />
<br />
<code>--branch "re:^(.{0,3}|.{5,}|[^m]...|m[^a]..|ma[^i].|mai[^n])$"</code><br />
<br />
Данное правило выбирает все ветки, кроме <code>main</code>.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:CLI/cleanup&diff=3575Help:CLI/cleanup2026-05-27T07:47:39Z<p>Mitrofanov: /* Шаблоны и паттерны */</p>
<hr />
<div>= Автоматическое удаление снимков =<br />
<br />
== Обзор ==<br />
<br />
Удаление происходит по умолчанию раз в 24 часа (время можно задать при запуске сервера опцией <code>--snapshots-cleanup-period</code>, либо в конфигурационном файле опцией <code>snapshots-cleanup-period</code>, либо переменной окружения <code>SVACER_CLEANUP_SNAPSHOTS_PERIOD</code>, но не меньше 15 минут). Первое удаление всех подходящих снимков будет выполнено через указанное время после запуска сервера.<br />
<br />
'''Принцип работы:''' происходит проверка всех снимков на соответствие правилам удаления и правилам на запрет удаления, после этого происходит удаление самых старых по времени создания подходящих снимков и заносится отметка в таблицу удаленных снимков и в системный журнал. После этого происходит удаление пустых веток и проектов в соответствии с правилами удаления. Также информация об удалении через cleanup вносится в системный журнал.<br />
<br />
Данная функциональность доступна пользователям с доступом '''ServerOperations'''.<br />
<br />
== Добавление нового правила удаления ==<br />
<br />
svacer server cleanup add-rule --user <user> --password <password> --project <project> --branch <branch> --snapshot <snapshot> --keep-time <nowiki><time></nowiki> --min-snapshots <min> --cleanup-type <type><br />
<br />
=== Параметры ===<br />
<br />
* <code>--project</code> — проект, в котором искать снимки для удаления ('''обязательный''', используйте <code>"*"</code> для всех проектов)<br />
* <code>--branch</code> — ветка, в которой искать снимки для удаления ('''обязательный''', используйте <code>"*"</code> для всех веток)<br />
* <code>--snapshot</code> — снимок, который удалять ('''обязательный''', используйте <code>"*"</code> для всех снимков)<br />
* <code>--keep-time</code> — время, которое должно пройти после создания '''(НЕ импорта)''' снимка, чтобы его удалить. Задается в формате Go Duration (например, <code>33h5m</code>, <code>720h</code>). По умолчанию '''720 часов''' (30 дней).<br />
* <code>--min-snapshots</code> — количество снимков, которое необходимо оставлять в ветке, подходящей под паттерн project + branch. По умолчанию 0.<br />
* <code>--cleanup-type</code> — тип очистки. Возможные значения - project, branch, snapshot (по умолчанию snapshot). При указании snapshot будут очищаться снимки в соответствии с паттерном проект+ветка+снимок и проверяться <code>keep-time</code> и <code>min-snapshots</code>. При указании branch будут удаляться пустые ветки в соответствии с паттерном project + branch. При указании project Будут удаляться пустые проекты (у которых нет веток) в соответствии с паттерном project. При указании branch или project невозможно указать <code>keep-time</code> и <code>min-snapshots</code>, эти флаги не учитываются.<br />
<br />
<br />
Значения параметров <code>--project</code>, <code>--branch</code>, <code>--snapshot</code> можно задавать как:<br />
<br />
'''1. Имя или UUID:'''<br />
--project "MyProject"<br />
--project "550e8400-e29b-41d4-a716-446655440000" # UUID проекта<br />
<br />
'''2. <code>*</code> (любое количество любых символов):'''<br />
--project "Dev*" # DevProject, Development<br />
--branch "*test*" # test, my-test, testing<br />
--snapshot "nightly-*"<br />
<br />
'''3. Регулярные выражения (с префиксом <code>re:</code>):'''<br />
--snapshot "re:^v[0-9]+\.[0-9]+\.[0-9]+$" # v1.0.0, v2.3.5<br />
--branch "re:^feature/[0-9]+$" # feature/123<br />
<br />
== Добавление запрета на удаление ==<br />
<br />
svacer server cleanup add-exclude-rule --user <user> --password <password> --project <project> --branch <branch> --snapshot <snapshot><br />
<br />
=== Параметры ===<br />
<br />
* <code>--project</code> — проект, в котором искать снимки для удаления ('''обязательный''' , используйте <code>"*"</code> для всех проектов)<br />
<br />
* <code>--branch</code> — ветка ('''обязательный''', используйте <code>"*"</code> для всех веток)<br />
* <code>--snapshot</code> — снимок ('''обязательный''', используйте <code>"*"</code> для всех снимков)<br />
Флаги проекта, ветки и снимка работают аналогично с флагами в <code>--add-rule</code>.<br />
<br />
== Удаление правила ==<br />
<br />
svacer server cleanup delete --user <user> --password <password> --id <config id><br />
<br />
Где:<br />
* <code>--id</code> — ID конфигурации из таблицы правил или запретов (получить через <code>cleanup list</code>)<br />
<br />
== Вывести таблицу ==<br />
<br />
svacer server cleanup list --user <user> --password <password> --type <rule|exclude-rule|log> --format <table|json><br />
<br />
Где:<br />
* <code>--type</code> — тип таблицы: <code>rule</code> — таблица правил удаления (по умолчанию); <code>exclude-rule</code> — таблица запретов на удаление; <code>log</code> — таблица удаленных снимков<br />
<br />
* <code>--format</code> — формат вывода: <code>table</code> — человекочитаемый вывод (по умолчанию); <code>json</code> — JSON формат<br />
== Запуск очистки вручную ==<br />
<br />
svacer server cleanup run --user <user> --password <password><br />
<br />
Запускает процесс очистки немедленно (вне расписания).<br />
<br />
== Примеры ==<br />
<br />
=== Добавление нового правила ===<br />
<br />
'''Удаление по времени'''<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "Devel*" --branch "2025" --snapshot "*" --keep-time 240h<br />
<br />
Удалятся снимки старше 240 часов (10 дней) в проектах, начинающихся с "Devel", в ветке "2025".<br />
<br />
'''Ограничение количества'''<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "*" --branch "main" --snapshot "*" --min-snapshots 20 --keep-time 12h<br />
<br />
В любом проекте в ветке "main" всегда будет не более 20 снимков; остальные снимки старше 12 часов будут удаляться.<br />
<br />
'''Очистка пустых веток'''<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "*" --branch "master" --cleanup-type branch<br />
<br />
В любом проекте ветка "master" будет удаляться, если в ней нет снимков.<br />
<br />
=== Добавление запрета на удаление ===<br />
<br />
svacer server cleanup add-exclude-rule --user admin --password admin --project "Devel*" --branch "2025" --snapshot "test*"<br />
<br />
Снимки, начинающиеся с "test", в проектах "Devel*" и ветке "2025" '''никогда не удаляются правилами cleanup'''.<br />
<br />
=== Вывод таблицы правил ===<br />
<br />
svacer server cleanup list --user admin --password admin --type rule<br />
[[File:Cleanup rules.png|none|thumb|955x955px]]<br />
<br />
=== Вывод таблицы запретов ===<br />
<br />
svacer server cleanup list --user admin --password admin --type exclude-rule<br />
[[File:Cleanup exclude rule table.png|none|thumb|1009x1009px]]<br />
<br />
=== Вывод в JSON формате ===<br />
<br />
svacer server cleanup list --user admin --password admin --type exclude-rule --format json<br />
<br />
Вывод:<br />
<br />
[{"Branch":"2025","CreatedBy":"admin","CreatedById":"00000000-0000-0000-0000-000000000000","ID":"018fe552-f390-4110-9545-6ef9cbe1a406","MinBranchSnapshots":0,"Project":"Devel*","Snapshot":"test*","create_time":"2025-10-13T15:00:14.997004Z"}]<br />
<br />
=== Удаление правила ===<br />
<br />
svacer server cleanup delete --user admin --password admin --id b1895877-1f3c-4b12-ac19-3ff4a7bc5416<br />
<br />
=== Использование regex ===<br />
<br />
svacer server cleanup add-rule --user admin --password admin --project "*" --branch "re:^feature/JIRA-[0-9]+$" --snapshot "*" --keep-time 168h<br />
<br />
Подходит: <code>feature/JIRA-123</code>, <code>feature/JIRA-456</code><br>Не подходит: <code>feature/JIRA-ABC</code>, <code>bugfix/JIRA-123</code><br />
<br />
=== Regex синтаксис ===<br />
<br />
{| class="wikitable"<br />
! Паттерн !! Описание !! Пример<br />
|-<br />
| <code>^</code> || Начало строки || <code>^test</code><br />
|-<br />
| <code>[^x]</code> || Отрицание символов || <code>^[^m].*$</code><br />
|-<br />
| <code>$</code> || Конец строки || <code>test$</code><br />
|-<br />
| <code>.</code> || Любой символ || <code>a.c</code> → abc, a1c<br />
|-<br />
| <code>.*</code> || Любое кол-во символов || <code>test.*</code> → test-123<br />
|-<br />
| <code>.+</code> || Один или более || <code>test.+</code> → test-1<br />
|-<br />
| <code>[0-9]</code> || Любая цифра || <code>v[0-9]</code> → v1, v9<br />
|-<br />
| <code>[a-z]</code> || Буква (нижний регистр) || <code>[a-z]+</code> → abc<br />
|-<br />
| <code>[A-Z]</code> || Буква (верхний регистр) || <code>[A-Z]+</code> → ABC<br />
|-<br />
| <code>(a&#124;b)</code> || "a" или "b" || <code>(test&#124;prod)</code><br />
|-<br />
| <code>[0-9]{2,4}</code> || От 2 до 4 цифр || <code>12</code>, <code>1234</code><br />
|}<br />
Не поддерживается '''negative lookahead''' <code>(?!...)</code>. Используйте комбинацию правил и запретов.<br />
<br />
Для правил отрицания конкретного элемента возможно использовать сложные правила, например:<br />
<br />
<code>--branch "re:^(.{0,3}|.{5,}|[^m]...|m[^a]..|ma[^i].|mai[^n])$"</code><br />
<br />
Данное правило выбирает все ветки, кроме <code>main</code>.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_deploy&diff=3563Help:13-alpha deploy2026-05-25T08:14:08Z<p>Mitrofanov: /* --profile mcp */</p>
<hr />
<div>== Демонстрационная сборка ==<br />
<br />
Установка демонстрационной версии Svacer с поддержкой [[Help:13-alpha introduction|описанных функций]] доступна только в докере с использованием docker compose<br />
<br />
== docker compose ==<br />
<br />
Для установки демонстрационной версии подготовлен специальный файл [https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml docker-compose-with-ai-llm-mcp.yml]<br />
<br />
<nowiki>curl -LO https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml</nowiki><br />
<br />
При запуске Svacer с использованием данного compose-файла доступны профили:<br />
<br />
{| class="wikitable"<br />
! Профиль !! Описание<br />
|-<br />
| Без профиля || Запуск Svacer без поддержки ИИ-ассистента и MCP<br />
|-<br />
| <code>ai</code> || Запуск Svacer с поддержкой ИИ-ассистента со встроенной моделью<br />
|-<br />
| <code>llm</code> || Запуск Svacer с поддержкой ИИ-ассистента и возможностью подключения к нему внешних LLM для разметки предупреждений<br />
|-<br />
| <code>mcp</code> || Запуск Svacer с MCP-сервером <br />
|}<br />
<br />
Для запуска с использованием одного или нескольких профилей используется команда<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml ... --profile llm --profile mcp ... up -d<br />
<br />
При этом необходимо учитывать, что<br />
<br />
* при запуске Svacer без профилей или только с профилем <code>mcp</code> функциональность разметки предупреждений с помощью ИИ будет возвращать ошибку;<br />
<!-- * Профиль <code>no-ai</code> не может быть использован одновременно с другими профилями; --><br />
* запуск с профилями <code>llm</code> и <code>mcp</code> требует настройки переменных окружения (см. ниже).<br />
<br />
Для удобства настройки переменных окружения может использоваться env-файл [https://svacer.ispras.ru/extra/llm-mcp.env llm-mcp.env], который после установки необходимых значений может быть передан команде запуска<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml --env-file ./llm-mcp.env ... --profile llm --profile mcp ... up -d<br />
<br />
<!-- == <code>--profile no-ai</code> == --><br />
<!-- Данный профиль не требует дополнительной конфигурации для запуска --><br />
== <code>--profile llm</code> ==<br />
Запуск Svacer с данным профилем даёт возможность подключить к ИИ-ассистенту внешний сервис моделей, поддерживающий OpenAI API. После успешного подключения ИИ-ассистент сможет использовать LLM для разметки и комментирования предупреждений. В списке разметки с помощью ИИ появятся модели доступные пользователю, чей ключ был передан при запуске.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>LLM_URL</code> значение url, по которому контейнер <code>svacer-validation-server</code> сможет подключиться к сервису моделей, совместимому с OpenAI API;<br />
* установить в переменную окружения <code>LLM_TOKEN</code> значение ключа авторизации в сервис моделей;<br />
* при необходимости установить значения переменных <code>REG_TOKEN</code> или <code>REG_LOGIN</code> и <code>REG_PASSWORD</code> содержащих, соответственно, токен авторизации или логин и пароль администратора. Эти данные нужны для запуска компонентов поддержки LLM в ИИ-ассистенте. По умолчанию будут использоваться логин и пароль <code>admin:admin</code>;<br />
* при желании изменить отображаемое название сервиса в интерфейсе выбора моделей, можно установить значение переменной <code>REG_NAME</code>. По умолчанию <code>llm</code>;<br />
* при необходимости ограничения списка доступных моделей, в переменную <code>MODEL_WHITELIST</code> нужно передать список названий моделей разделённых запятыми;<br />
* если производительность сервиса моделей позволяет параллельно обрабатывать несколько предупреждений, то можно установить значение переменной <code>MAX_PARALLEL_REQUESTS</code> в значение больше единицы;<br />
* если производительность модели не позволяет обрабатывать одно предупреждение в минуту, то результаты обработки не будут получены. Чтобы увеличить время ожидания новых результатов модели, можно установить значение переменной <code>MODEL_VALIDATION_MAXATTEMPTS</code> в значение кратное 12 (двенадцати). Например, значение 60 == 5 минут.<br />
<br />
Значения данных переменных могут быть сохранены в <code>.env</code> файл и переданы при запуске с помощью аргумента <code>docker compose --env-file ./.env ... up -d</code><br />
<br />
Описание переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# URL of the OpenAI API-compatible LLM hosting service<br />
LLM_URL=<br />
<br />
# LLM hosting service authorization token<br />
LLM_TOKEN=<br />
<br />
# Svacer admin authorization token, which will be used to perform LLM service registration requests in the AI assistant. <br />
# Or with REG_LOGIN and REG_PASSWORD, if token is not set<br />
# REG_TOKEN=<br />
<br />
# Svacer admin login and password<br />
# REG_LOGIN=admin<br />
# REG_PASSWORD=admin<br />
<br />
# ID of the service in the AI assistant<br />
# REG_ID=llm<br />
<br />
# The name of the service displayed in the AI assistant<br />
# REG_NAME=llm<br />
<br />
# Service description<br />
# REG_DESCRIPTION="LLM hosting service"<br />
<br />
# Comma-separated list of available models. If not specified, all models available to the LLM hosting service user will be available.<br />
# MODEL_WHITELIST=<br />
<br />
# Maximum number of simultaneous requests to process warning with LLM<br />
# MAX_PARALLEL_REQUESTS=1<br />
<br />
# Maximum number of 5s attempts to get single warning result from LLM<br />
# MODEL_VALIDATION_MAXATTEMPTS=12<br />
</pre><br />
<br />
== <code>--profile mcp</code> ==<br />
При запуске с данным профилем стартует контейнер с MCP-сервером, подключённый к текущему экземпляру Svacer.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>MCP_PORT</code> номер сетевого порта на котором будет доступен MCP-сервер. По умолчанию будет назначен порт <code>8002</code><br />
* установить в переменную окружения <code>SVACER_MPC_TOKEN</code> строку с токеном авторизации, который необходимо будет указать в клиенте MCP-сервера;<br />
* при необходимости доступа к MCP-серверу по адресу отличному от <code>localhost</code> (<code>127.0.0.1</code>) или при использовании DNS необходимо:<br />
** указать необходимый адрес/dns-имя в переменной <code>MCP_ALLOWED_HOSTS</code> в виде <code>172.17.0.1:*</code>/<code>some.domain:*</code><br />
** указать необходимый адрес/dns-имя в переменной <code><nowiki>MCP_ALLOWED_ORIGINS</nowiki></code> в виде <code><nowiki>http://172.17.0.1:*</nowiki></code>/<code><nowiki>http://some.domain:*</nowiki></code><br />
* при необходимости можно настроить логин и пароль пользователя, от имени которого MCP-сервер будет выполнять запросы к Svacer. По умолчанию <code>admin:admin</code><br />
После запуска mcp-сервер будет доступен по адресу <code><nowiki>http://localhost:{MCP_PORT}/mcp</nowiki></code><br />
<br />
Описание других переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# Bearer token for /mcp clients in HTTP mode. Generate: openssl rand -hex 32<br />
SVACER_MCP_TOKEN=<br />
<br />
# Svacer admin login and password<br />
SVACER_LOGIN=admin<br />
SVACER_PASSWORD=admin<br />
<br />
# External port that will be mapped by docker to the internal port 8000<br />
MCP_PORT=8002<br />
<br />
MCP_ALLOWED_HOSTS=172.17.0.1:*<br />
MCP_ALLOWED_ORIGINS=http://172.17.0.1:*<br />
<br />
# Svacer server (container) URL<br />
# SVACER_URL=http://svacer:8080<br />
<br />
# HTTP timeout for requests to Svacer, seconds<br />
# SVACER_TIMEOUT=30<br />
<br />
# Public URL of this MCP server (used for WWW-Authenticate, RFC 9728).<br />
# Defaults to http://localhost:<SVACER_HTTP_PORT>. Set when running behind a reverse proxy.<br />
# SVACER_MCP_RESOURCE_URL=https://mcp.example.com<br />
<br />
# Subset of tools to register (comma-separated). Unset = all 8 tools.<br />
# Available: get_projects, get_snapshots, get_warnings, get_markers,<br />
# get_project_stats, get_project_groups, get_advanced_file_preview, get_diff<br />
# SVACER_TOOLS=get_projects,get_snapshots,get_markers<br />
</pre></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_deploy&diff=3562Help:13-alpha deploy2026-05-25T08:13:38Z<p>Mitrofanov: </p>
<hr />
<div>== Демонстрационная сборка ==<br />
<br />
Установка демонстрационной версии Svacer с поддержкой [[Help:13-alpha introduction|описанных функций]] доступна только в докере с использованием docker compose<br />
<br />
== docker compose ==<br />
<br />
Для установки демонстрационной версии подготовлен специальный файл [https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml docker-compose-with-ai-llm-mcp.yml]<br />
<br />
<nowiki>curl -LO https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml</nowiki><br />
<br />
При запуске Svacer с использованием данного compose-файла доступны профили:<br />
<br />
{| class="wikitable"<br />
! Профиль !! Описание<br />
|-<br />
| Без профиля || Запуск Svacer без поддержки ИИ-ассистента и MCP<br />
|-<br />
| <code>ai</code> || Запуск Svacer с поддержкой ИИ-ассистента со встроенной моделью<br />
|-<br />
| <code>llm</code> || Запуск Svacer с поддержкой ИИ-ассистента и возможностью подключения к нему внешних LLM для разметки предупреждений<br />
|-<br />
| <code>mcp</code> || Запуск Svacer с MCP-сервером <br />
|}<br />
<br />
Для запуска с использованием одного или нескольких профилей используется команда<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml ... --profile llm --profile mcp ... up -d<br />
<br />
При этом необходимо учитывать, что<br />
<br />
* при запуске Svacer без профилей или только с профилем <code>mcp</code> функциональность разметки предупреждений с помощью ИИ будет возвращать ошибку;<br />
<!-- * Профиль <code>no-ai</code> не может быть использован одновременно с другими профилями; --><br />
* запуск с профилями <code>llm</code> и <code>mcp</code> требует настройки переменных окружения (см. ниже).<br />
<br />
Для удобства настройки переменных окружения может использоваться env-файл [https://svacer.ispras.ru/extra/llm-mcp.env llm-mcp.env], который после установки необходимых значений может быть передан команде запуска<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml --env-file ./llm-mcp.env ... --profile llm --profile mcp ... up -d<br />
<br />
<!-- == <code>--profile no-ai</code> == --><br />
<!-- Данный профиль не требует дополнительной конфигурации для запуска --><br />
== <code>--profile llm</code> ==<br />
Запуск Svacer с данным профилем даёт возможность подключить к ИИ-ассистенту внешний сервис моделей, поддерживающий OpenAI API. После успешного подключения ИИ-ассистент сможет использовать LLM для разметки и комментирования предупреждений. В списке разметки с помощью ИИ появятся модели доступные пользователю, чей ключ был передан при запуске.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>LLM_URL</code> значение url, по которому контейнер <code>svacer-validation-server</code> сможет подключиться к сервису моделей, совместимому с OpenAI API;<br />
* установить в переменную окружения <code>LLM_TOKEN</code> значение ключа авторизации в сервис моделей;<br />
* при необходимости установить значения переменных <code>REG_TOKEN</code> или <code>REG_LOGIN</code> и <code>REG_PASSWORD</code> содержащих, соответственно, токен авторизации или логин и пароль администратора. Эти данные нужны для запуска компонентов поддержки LLM в ИИ-ассистенте. По умолчанию будут использоваться логин и пароль <code>admin:admin</code>;<br />
* при желании изменить отображаемое название сервиса в интерфейсе выбора моделей, можно установить значение переменной <code>REG_NAME</code>. По умолчанию <code>llm</code>;<br />
* при необходимости ограничения списка доступных моделей, в переменную <code>MODEL_WHITELIST</code> нужно передать список названий моделей разделённых запятыми;<br />
* если производительность сервиса моделей позволяет параллельно обрабатывать несколько предупреждений, то можно установить значение переменной <code>MAX_PARALLEL_REQUESTS</code> в значение больше единицы;<br />
* если производительность модели не позволяет обрабатывать одно предупреждение в минуту, то результаты обработки не будут получены. Чтобы увеличить время ожидания новых результатов модели, можно установить значение переменной <code>MODEL_VALIDATION_MAXATTEMPTS</code> в значение кратное 12 (двенадцати). Например, значение 60 == 5 минут.<br />
<br />
Значения данных переменных могут быть сохранены в <code>.env</code> файл и переданы при запуске с помощью аргумента <code>docker compose --env-file ./.env ... up -d</code><br />
<br />
Описание переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# URL of the OpenAI API-compatible LLM hosting service<br />
LLM_URL=<br />
<br />
# LLM hosting service authorization token<br />
LLM_TOKEN=<br />
<br />
# Svacer admin authorization token, which will be used to perform LLM service registration requests in the AI assistant. <br />
# Or with REG_LOGIN and REG_PASSWORD, if token is not set<br />
# REG_TOKEN=<br />
<br />
# Svacer admin login and password<br />
# REG_LOGIN=admin<br />
# REG_PASSWORD=admin<br />
<br />
# ID of the service in the AI assistant<br />
# REG_ID=llm<br />
<br />
# The name of the service displayed in the AI assistant<br />
# REG_NAME=llm<br />
<br />
# Service description<br />
# REG_DESCRIPTION="LLM hosting service"<br />
<br />
# Comma-separated list of available models. If not specified, all models available to the LLM hosting service user will be available.<br />
# MODEL_WHITELIST=<br />
<br />
# Maximum number of simultaneous requests to process warning with LLM<br />
# MAX_PARALLEL_REQUESTS=1<br />
<br />
# Maximum number of 5s attempts to get single warning result from LLM<br />
# MODEL_VALIDATION_MAXATTEMPTS=12<br />
</pre><br />
<br />
== <code>--profile mcp</code> ==<br />
При запуске с данным профилем стартует контейнер с MCP-сервером, подключённый к текущему экземпляру Svacer.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>MCP_PORT</code> номер сетевого порта на котором будет доступен MCP-сервер. По умолчанию будет назначен порт <code>8002</code><br />
* установить в переменную окружения <code>SVACER_MPC_TOKEN</code> строку с токеном авторизации, который необходимо будет указать в клиенте MCP-сервера;<br />
* при необходимости доступа к MCP-серверу по адресу отличному от <code>localhost</code> (<code>127.0.0.1</code>) или при использовании DNS необходимо:<br />
** указать необходимый адрес/dns-имя в переменной <code>MCP_ALLOWED_HOSTS</code> в виде <code>172.17.0.1:*</code>/<code>some.domain:*</code><br />
** указать необходимый адрес/dns-имя в переменной <code><nowiki>MCP_ALLOWED_ORIGINS</nowiki></code> в виде <code><nowiki>http://172.17.0.1:*</nowiki></code>/<code><nowiki>http://some.domain:*</nowiki></code><br />
* при необходимости можно настроить логин и пароль пользователя, от имени которого MCP-сервер будет выполнять запросы к Svacer. По умолчанию: <code>admin:admin</code><br />
После запуска mcp-сервер будет доступен по адресу <code><nowiki>http://localhost:{MCP_PORT}/mcp</nowiki></code><br />
<br />
Описание других переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# Bearer token for /mcp clients in HTTP mode. Generate: openssl rand -hex 32<br />
SVACER_MCP_TOKEN=<br />
<br />
# Svacer admin login and password<br />
SVACER_LOGIN=admin<br />
SVACER_PASSWORD=admin<br />
<br />
# External port that will be mapped by docker to the internal port 8000<br />
MCP_PORT=8002<br />
<br />
MCP_ALLOWED_HOSTS=172.17.0.1:*<br />
MCP_ALLOWED_ORIGINS=http://172.17.0.1:*<br />
<br />
# Svacer server (container) URL<br />
# SVACER_URL=http://svacer:8080<br />
<br />
# HTTP timeout for requests to Svacer, seconds<br />
# SVACER_TIMEOUT=30<br />
<br />
# Public URL of this MCP server (used for WWW-Authenticate, RFC 9728).<br />
# Defaults to http://localhost:<SVACER_HTTP_PORT>. Set when running behind a reverse proxy.<br />
# SVACER_MCP_RESOURCE_URL=https://mcp.example.com<br />
<br />
# Subset of tools to register (comma-separated). Unset = all 8 tools.<br />
# Available: get_projects, get_snapshots, get_warnings, get_markers,<br />
# get_project_stats, get_project_groups, get_advanced_file_preview, get_diff<br />
# SVACER_TOOLS=get_projects,get_snapshots,get_markers<br />
</pre></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_deploy&diff=3560Help:13-alpha deploy2026-05-25T07:36:15Z<p>Mitrofanov: </p>
<hr />
<div>== Демонстрационная сборка ==<br />
<br />
Установка демонстрационной версии Svacer с поддержкой [[Help:13-alpha introduction|описанных функций]] доступна только в докере с использованием docker compose<br />
<br />
== docker compose ==<br />
<br />
Для установки демонстрационной версии подготовлен специальный файл [https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml docker-compose-with-ai-llm-mcp.yml]<br />
<br />
<nowiki>curl -LO https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml</nowiki><br />
<br />
При запуске Svacer с использованием данного compose-файла доступны профили:<br />
<br />
{| class="wikitable"<br />
! Профиль !! Описание<br />
|-<br />
| Без профиля || Запуск Svacer без поддержки ИИ-ассистента и MCP<br />
|-<br />
| <code>ai</code> || Запуск Svacer с поддержкой ИИ-ассистента со встроенной моделью<br />
|-<br />
| <code>llm</code> || Запуск Svacer с поддержкой ИИ-ассистента и возможностью подключения к нему внешних LLM для разметки предупреждений<br />
|-<br />
| <code>mcp</code> || Запуск Svacer с MCP-сервером <br />
|}<br />
<br />
Для запуска с использованием одного или нескольких профилей используется команда<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml ... --profile llm --profile mcp ... up -d<br />
<br />
При этом необходимо учитывать, что<br />
<br />
* при запуске Svacer без профилей или только с профилем <code>mcp</code> функциональность разметки предупреждений с помощью ИИ будет возвращать ошибку;<br />
<!-- * Профиль <code>no-ai</code> не может быть использован одновременно с другими профилями; --><br />
* запуск с профилями <code>llm</code> и <code>mcp</code> требует настройки переменных окружения (см. ниже).<br />
<br />
Для удобства настройки переменных окружения может использоваться env-файл [https://svacer.ispras.ru/extra/llm-mcp.env llm-mcp.env], который после установки необходимых значений может быть передан команде запуска<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml --env-file ./llm-mcp.env ... --profile llm --profile mcp ... up -d<br />
<br />
<!-- == <code>--profile no-ai</code> == --><br />
<!-- Данный профиль не требует дополнительной конфигурации для запуска --><br />
== <code>--profile llm</code> ==<br />
Запуск Svacer с данным профилем даёт возможность подключить к ИИ-ассистенту внешний сервис моделей, поддерживающий OpenAI API. После успешного подключения ИИ-ассистент сможет использовать LLM для разметки и комментирования предупреждений. В списке разметки с помощью ИИ появятся модели доступные пользователю, чей ключ был передан при запуске.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>LLM_URL</code> значение url, по которому контейнер <code>svacer-validation-server</code> сможет подключиться к сервису моделей, совместимому с OpenAI API;<br />
* установить в переменную окружения <code>LLM_TOKEN</code> значение ключа авторизации в сервис моделей;<br />
* при необходимости установить значения переменных <code>REG_TOKEN</code> или <code>REG_LOGIN</code> и <code>REG_PASSWORD</code> содержащих, соответственно, токен авторизации или логин и пароль администратора. Эти данные нужны для запуска компонентов поддержки LLM в ИИ-ассистенте. По умолчанию будут использоваться логин и пароль <code>admin:admin</code>;<br />
* при желании изменить отображаемое название сервиса в интерфейсе выбора моделей, можно установить значение переменной <code>REG_NAME</code>. По умолчанию: <code>llm</code>;<br />
* при необходимости ограничения списка доступных моделей, в переменную <code>MODEL_WHITELIST</code> нужно передать список названий моделей разделённых запятыми;<br />
* если производительность сервиса моделей позволяет параллельно обрабатывать несколько предупреждений, то можно установить значение переменной <code>MAX_PARALLEL_REQUESTS</code> в значение больше единицы;<br />
* если производительность модели не позволяет обрабатывать одно предупреждение в минуту, то результаты обработки не будут получены. Чтобы увеличить время ожидания новых результатов модели, можно установить значение переменной <code>MODEL_VALIDATION_MAXATTEMPTS</code> в значение кратное 12 (двенадцати). Например, значение 60 == 5 минут.<br />
<br />
В процессе обработки набора маркеров с помощью LLM ИИ-ассистент ожидает, что за минуту будет обрабатываться хотя бы один маркер. Если в течение минуты не появятся новы<br />
<br />
Значения данных переменных могут быть сохранены в <code>.env</code> файл и переданы при запуске с помощью аргумента <code>docker compose --env-file ./.env ... up -d</code><br />
<br />
Описание переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# URL of the OpenAI API-compatible LLM hosting service<br />
LLM_URL=<br />
<br />
# LLM hosting service authorization token<br />
LLM_TOKEN=<br />
<br />
# Svacer admin authorization token, which will be used to perform LLM service registration requests in the AI assistant. <br />
# Or with REG_LOGIN and REG_PASSWORD, if token is not set<br />
# REG_TOKEN=<br />
<br />
# Svacer admin login and password<br />
# REG_LOGIN=admin<br />
# REG_PASSWORD=admin<br />
<br />
# ID of the service in the AI assistant<br />
# REG_ID=llm<br />
<br />
# The name of the service displayed in the AI assistant<br />
# REG_NAME=llm<br />
<br />
# Service description<br />
# REG_DESCRIPTION="LLM hosting service"<br />
<br />
# Comma-separated list of available models. If not specified, all models available to the LLM hosting service user will be available.<br />
# MODEL_WHITELIST=<br />
<br />
# Maximum number of simultaneous requests to process warning with LLM<br />
# MAX_PARALLEL_REQUESTS=1<br />
<br />
# Maximum number of 5s attempts to get single warning result from LLM<br />
# MODEL_VALIDATION_MAXATTEMPTS=12<br />
</pre><br />
<br />
== <code>--profile mcp</code> ==<br />
При запуске с данным профилем стартует контейнер с MCP-сервером, подключённый к текущему экземпляру Svacer.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>MCP_PORT</code> номер сетевого порта на котором будет доступен MCP-сервер. По умолчанию будет назначен порт <code>8002</code><br />
* установить в переменную окружения <code>SVACER_MPC_TOKEN</code> строку с токеном авторизации, который необходимо будет указать в клиенте MCP-сервера;<br />
* при необходимости доступа к MCP-серверу по адресу отличному от <code>localhost</code> (<code>127.0.0.1</code>) или при использовании DNS необходимо:<br />
** указать необходимый адрес/dns-имя в переменной <code>MCP_ALLOWED_HOSTS</code> в виде <code>172.17.0.1:*</code>/<code>some.domain:*</code><br />
** указать необходимый адрес/dns-имя в переменной <code><nowiki>MCP_ALLOWED_ORIGINS</nowiki></code> в виде <code><nowiki>http://172.17.0.1:*</nowiki></code>/<code><nowiki>http://some.domain:*</nowiki></code><br />
* при необходимости можно настроить логин и пароль пользователя, от имени которого MCP-сервер будет выполнять запросы к Svacer. По умолчанию: <code>admin:admin</code><br />
После запуска mcp-сервер будет доступен по адресу <code><nowiki>http://localhost:{MCP_PORT}/mcp</nowiki></code><br />
<br />
Описание других переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# Bearer token for /mcp clients in HTTP mode. Generate: openssl rand -hex 32<br />
SVACER_MCP_TOKEN=<br />
<br />
# Svacer admin login and password<br />
SVACER_LOGIN=admin<br />
SVACER_PASSWORD=admin<br />
<br />
# External port that will be mapped by docker to the internal port 8000<br />
MCP_PORT=8002<br />
<br />
MCP_ALLOWED_HOSTS=172.17.0.1:*<br />
MCP_ALLOWED_ORIGINS=http://172.17.0.1:*<br />
<br />
# Svacer server (container) URL<br />
# SVACER_URL=http://svacer:8080<br />
<br />
# HTTP timeout for requests to Svacer, seconds<br />
# SVACER_TIMEOUT=30<br />
<br />
# Public URL of this MCP server (used for WWW-Authenticate, RFC 9728).<br />
# Defaults to http://localhost:<SVACER_HTTP_PORT>. Set when running behind a reverse proxy.<br />
# SVACER_MCP_RESOURCE_URL=https://mcp.example.com<br />
<br />
# Subset of tools to register (comma-separated). Unset = all 8 tools.<br />
# Available: get_projects, get_snapshots, get_warnings, get_markers,<br />
# get_project_stats, get_project_groups, get_advanced_file_preview, get_diff<br />
# SVACER_TOOLS=get_projects,get_snapshots,get_markers<br />
</pre></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_deploy&diff=3559Help:13-alpha deploy2026-05-25T07:25:07Z<p>Mitrofanov: /* --profile mcp */</p>
<hr />
<div>== Демонстрационная сборка ==<br />
<br />
Установка демонстрационной версии Svacer с поддержкой [[Help:13-alpha introduction|описанных функций]] доступна только в докере с использованием docker compose<br />
<br />
== docker compose ==<br />
<br />
Для установки демонстрационной версии подготовлен специальный файл [https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml docker-compose-with-ai-llm-mcp.yml]<br />
<br />
<nowiki>curl -LO https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml</nowiki><br />
<br />
При запуске Svacer с использованием данного compose-файла доступны профили:<br />
<br />
{| class="wikitable"<br />
! Профиль !! Описание<br />
|-<br />
| Без профиля || Запуск Svacer без поддержки ИИ-ассистента и MCP<br />
|-<br />
| <code>ai</code> || Запуск Svacer с поддержкой ИИ-ассистента со встроенной моделью<br />
|-<br />
| <code>llm</code> || Запуск Svacer с поддержкой ИИ-ассистента и возможностью подключения к нему внешних LLM для разметки предупреждений<br />
|-<br />
| <code>mcp</code> || Запуск Svacer с MCP-сервером <br />
|}<br />
<br />
Для запуска с использованием одного или нескольких профилей используется команда<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml ... --profile llm --profile mcp ... up -d<br />
<br />
При этом необходимо учитывать, что<br />
<br />
* при запуске Svacer без профилей или только с профилем <code>mcp</code> функциональность разметки предупреждений с помощью ИИ будет возвращать ошибку;<br />
<!-- * Профиль <code>no-ai</code> не может быть использован одновременно с другими профилями; --><br />
* запуск с профилями <code>llm</code> и <code>mcp</code> требует настройки переменных окружения (см. ниже).<br />
<br />
Для удобства настройки переменных окружения может использоваться env-файл [https://svacer.ispras.ru/extra/llm-mcp.env llm-mcp.env], который после установки необходимых значений может быть передан команде запуска<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml --env-file ./llm-mcp.env ... --profile llm --profile mcp ... up -d<br />
<br />
<!-- == <code>--profile no-ai</code> == --><br />
<!-- Данный профиль не требует дополнительной конфигурации для запуска --><br />
== <code>--profile llm</code> ==<br />
Запуск Svacer с данным профилем даёт возможность подключить к ИИ-ассистенту внешний сервис моделей, поддерживающий OpenAI API. После успешного подключения ИИ-ассистент сможет использовать LLM для разметки и комментирования предупреждений. В списке разметки с помощью ИИ появятся модели доступные пользователю, чей ключ был передан при запуске.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>LLM_URL</code> значение url, по которому контейнер <code>svacer-validation-server</code> сможет подключиться к сервису моделей, совместимому с OpenAI API;<br />
* установить в переменную окружения <code>LLM_TOKEN</code> значение ключа авторизации в сервис моделей;<br />
* при необходимости установить значения переменных <code>REG_TOKEN</code> или <code>REG_LOGIN</code> и <code>REG_PASSWORD</code> содержащих, соответственно, токен авторизации или логин и пароль администратора. Эти данные нужны для запуска компонентов поддержки LLM в ИИ-ассистенте. По умолчанию будут использоваться логин и пароль <code>admin/admin</code>;<br />
* при желании изменить отображаемое название сервиса в интерфейсе выбора моделей, можно установить значение переменной <code>REG_NAME</code>. По умолчанию: <code>llm</code>;<br />
* при необходимости ограничения списка доступных моделей, в переменную <code>MODEL_WHITELIST</code> нужно передать список названий моделей разделённых запятыми;<br />
* если производительность сервиса моделей позволяет параллельно обрабатывать несколько предупреждений, то можно установить значение переменной <code>MAX_PARALLEL_REQUESTS</code> в значение больше единицы;<br />
* если производительность модели не позволяет обрабатывать одно предупреждение в минуту, то результаты обработки не будут получены. Чтобы увеличить время ожидания новых результатов модели, можно установить значение переменной <code>MODEL_VALIDATION_MAXATTEMPTS</code> в значение кратное 12 (двенадцати). Например, значение 60 == 5 минут.<br />
<br />
В процессе обработки набора маркеров с помощью LLM ИИ-ассистент ожидает, что за минуту будет обрабатываться хотя бы один маркер. Если в течение минуты не появятся новы<br />
<br />
Значения данных переменных могут быть сохранены в <code>.env</code> файл и переданы при запуске с помощью аргумента <code>docker compose --env-file ./.env ... up -d</code><br />
<br />
Описание переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# URL of the OpenAI API-compatible LLM hosting service<br />
LLM_URL=<br />
<br />
# LLM hosting service authorization token<br />
LLM_TOKEN=<br />
<br />
# Svacer admin authorization token, which will be used to perform LLM service registration requests in the AI assistant. <br />
# Or with REG_LOGIN and REG_PASSWORD, if token is not set<br />
# REG_TOKEN=<br />
<br />
# Svacer admin login and password<br />
# REG_LOGIN=admin<br />
# REG_PASSWORD=admin<br />
<br />
# ID of the service in the AI assistant<br />
# REG_ID=llm<br />
<br />
# The name of the service displayed in the AI assistant<br />
# REG_NAME=llm<br />
<br />
# Service description<br />
# REG_DESCRIPTION="LLM hosting service"<br />
<br />
# Comma-separated list of available models. If not specified, all models available to the LLM hosting service user will be available.<br />
# MODEL_WHITELIST=<br />
<br />
# Maximum number of simultaneous requests to process warning with LLM<br />
# MAX_PARALLEL_REQUESTS=1<br />
<br />
# Maximum number of 5s attempts to get single warning result from LLM<br />
# MODEL_VALIDATION_MAXATTEMPTS=12<br />
</pre><br />
<br />
== <code>--profile mcp</code> ==<br />
При запуске с данным профилем стартует контейнер с MCP-сервером, подключённый к текущему экземпляру Svacer.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>MCP_PORT</code> номер сетевого порта на котором будет доступен MCP-сервер. По умолчанию будет назначен порт <code>8002</code><br />
* установить в переменную окружения <code>SVACER_MPC_TOKEN</code> строку с токеном авторизации, который необходимо будет указать в клиенте MCP-сервера;<br />
* при необходимости доступа к MCP-серверу по адресу отличному от <code>localhost</code> (<code>127.0.0.1</code>) или при использовании DNS необходимо:<br />
** указать необходимый адрес/dns-имя в переменной <code>MCP_ALLOWED_HOSTS</code> в виде <code>172.17.0.1:*</code>/<code>some.domain:*</code><br />
** указать необходимый адрес/dns-имя в переменной <code><nowiki>MCP_ALLOWED_ORIGINS</nowiki></code> в виде <code><nowiki>http://172.17.0.1:*</nowiki></code>/<code><nowiki>http://some.domain:*</nowiki></code><br />
* при необходимости можно настроить логин и пароль пользователя, от имени которого MCP-сервер будет выполнять запросы к Svacer. По умолчанию: <code>admin/admin</code><br />
После запуска mcp-сервер будет доступен по адресу <code><nowiki>http://localhost:{MCP_PORT}/mcp</nowiki></code><br />
<br />
Описание других переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# Bearer token for /mcp clients in HTTP mode. Generate: openssl rand -hex 32<br />
SVACER_MCP_TOKEN=<br />
<br />
# Svacer admin login and password<br />
SVACER_LOGIN=admin<br />
SVACER_PASSWORD=admin<br />
<br />
# External port that will be mapped by docker to the internal port 8000<br />
MCP_PORT=8002<br />
<br />
MCP_ALLOWED_HOSTS=172.17.0.1:*<br />
MCP_ALLOWED_ORIGINS=http://172.17.0.1:*<br />
<br />
# Svacer server (container) URL<br />
# SVACER_URL=http://svacer:8080<br />
<br />
# HTTP timeout for requests to Svacer, seconds<br />
# SVACER_TIMEOUT=30<br />
<br />
# Public URL of this MCP server (used for WWW-Authenticate, RFC 9728).<br />
# Defaults to http://localhost:<SVACER_HTTP_PORT>. Set when running behind a reverse proxy.<br />
# SVACER_MCP_RESOURCE_URL=https://mcp.example.com<br />
<br />
# Subset of tools to register (comma-separated). Unset = all 8 tools.<br />
# Available: get_projects, get_snapshots, get_warnings, get_markers,<br />
# get_project_stats, get_project_groups, get_advanced_file_preview, get_diff<br />
# SVACER_TOOLS=get_projects,get_snapshots,get_markers<br />
</pre></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_deploy&diff=3558Help:13-alpha deploy2026-05-25T07:20:49Z<p>Mitrofanov: /* --profile llm */</p>
<hr />
<div>== Демонстрационная сборка ==<br />
<br />
Установка демонстрационной версии Svacer с поддержкой [[Help:13-alpha introduction|описанных функций]] доступна только в докере с использованием docker compose<br />
<br />
== docker compose ==<br />
<br />
Для установки демонстрационной версии подготовлен специальный файл [https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml docker-compose-with-ai-llm-mcp.yml]<br />
<br />
<nowiki>curl -LO https://svacer.ispras.ru/extra/docker-compose-with-ai-llm-mcp.yml</nowiki><br />
<br />
При запуске Svacer с использованием данного compose-файла доступны профили:<br />
<br />
{| class="wikitable"<br />
! Профиль !! Описание<br />
|-<br />
| Без профиля || Запуск Svacer без поддержки ИИ-ассистента и MCP<br />
|-<br />
| <code>ai</code> || Запуск Svacer с поддержкой ИИ-ассистента со встроенной моделью<br />
|-<br />
| <code>llm</code> || Запуск Svacer с поддержкой ИИ-ассистента и возможностью подключения к нему внешних LLM для разметки предупреждений<br />
|-<br />
| <code>mcp</code> || Запуск Svacer с MCP-сервером <br />
|}<br />
<br />
Для запуска с использованием одного или нескольких профилей используется команда<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml ... --profile llm --profile mcp ... up -d<br />
<br />
При этом необходимо учитывать, что<br />
<br />
* при запуске Svacer без профилей или только с профилем <code>mcp</code> функциональность разметки предупреждений с помощью ИИ будет возвращать ошибку;<br />
<!-- * Профиль <code>no-ai</code> не может быть использован одновременно с другими профилями; --><br />
* запуск с профилями <code>llm</code> и <code>mcp</code> требует настройки переменных окружения (см. ниже).<br />
<br />
Для удобства настройки переменных окружения может использоваться env-файл [https://svacer.ispras.ru/extra/llm-mcp.env llm-mcp.env], который после установки необходимых значений может быть передан команде запуска<br />
<br />
docker compose -f docker-compose-with-ai-llm-mcp.yml --env-file ./llm-mcp.env ... --profile llm --profile mcp ... up -d<br />
<br />
<!-- == <code>--profile no-ai</code> == --><br />
<!-- Данный профиль не требует дополнительной конфигурации для запуска --><br />
== <code>--profile llm</code> ==<br />
Запуск Svacer с данным профилем даёт возможность подключить к ИИ-ассистенту внешний сервис моделей, поддерживающий OpenAI API. После успешного подключения ИИ-ассистент сможет использовать LLM для разметки и комментирования предупреждений. В списке разметки с помощью ИИ появятся модели доступные пользователю, чей ключ был передан при запуске.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>LLM_URL</code> значение url, по которому контейнер <code>svacer-validation-server</code> сможет подключиться к сервису моделей, совместимому с OpenAI API;<br />
* установить в переменную окружения <code>LLM_TOKEN</code> значение ключа авторизации в сервис моделей;<br />
* при необходимости установить значения переменных <code>REG_TOKEN</code> или <code>REG_LOGIN</code> и <code>REG_PASSWORD</code> содержащих, соответственно, токен авторизации или логин и пароль администратора. Эти данные нужны для запуска компонентов поддержки LLM в ИИ-ассистенте. По умолчанию будут использоваться логин и пароль <code>admin/admin</code>;<br />
* при желании изменить отображаемое название сервиса в интерфейсе выбора моделей, можно установить значение переменной <code>REG_NAME</code>. По умолчанию: <code>llm</code>;<br />
* при необходимости ограничения списка доступных моделей, в переменную <code>MODEL_WHITELIST</code> нужно передать список названий моделей разделённых запятыми;<br />
* если производительность сервиса моделей позволяет параллельно обрабатывать несколько предупреждений, то можно установить значение переменной <code>MAX_PARALLEL_REQUESTS</code> в значение больше единицы;<br />
* если производительность модели не позволяет обрабатывать одно предупреждение в минуту, то результаты обработки не будут получены. Чтобы увеличить время ожидания новых результатов модели, можно установить значение переменной <code>MODEL_VALIDATION_MAXATTEMPTS</code> в значение кратное 12 (двенадцати). Например, значение 60 == 5 минут.<br />
<br />
В процессе обработки набора маркеров с помощью LLM ИИ-ассистент ожидает, что за минуту будет обрабатываться хотя бы один маркер. Если в течение минуты не появятся новы<br />
<br />
Значения данных переменных могут быть сохранены в <code>.env</code> файл и переданы при запуске с помощью аргумента <code>docker compose --env-file ./.env ... up -d</code><br />
<br />
Описание переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# URL of the OpenAI API-compatible LLM hosting service<br />
LLM_URL=<br />
<br />
# LLM hosting service authorization token<br />
LLM_TOKEN=<br />
<br />
# Svacer admin authorization token, which will be used to perform LLM service registration requests in the AI assistant. <br />
# Or with REG_LOGIN and REG_PASSWORD, if token is not set<br />
# REG_TOKEN=<br />
<br />
# Svacer admin login and password<br />
# REG_LOGIN=admin<br />
# REG_PASSWORD=admin<br />
<br />
# ID of the service in the AI assistant<br />
# REG_ID=llm<br />
<br />
# The name of the service displayed in the AI assistant<br />
# REG_NAME=llm<br />
<br />
# Service description<br />
# REG_DESCRIPTION="LLM hosting service"<br />
<br />
# Comma-separated list of available models. If not specified, all models available to the LLM hosting service user will be available.<br />
# MODEL_WHITELIST=<br />
<br />
# Maximum number of simultaneous requests to process warning with LLM<br />
# MAX_PARALLEL_REQUESTS=1<br />
<br />
# Maximum number of 5s attempts to get single warning result from LLM<br />
# MODEL_VALIDATION_MAXATTEMPTS=12<br />
</pre><br />
<br />
== <code>--profile mcp</code> ==<br />
При запуске с данным профилем стартует контейнер с MCP-сервером подключённый к текущему экземпляру Svacer.<br />
<br />
При запуске Svacer с профилем <code>llm</code> необходимо:<br />
* установить в переменную окружения <code>MCP_PORT</code> номер сетевого порта на котором будет доступен MCP-сервер. По умолчанию будет назначен порт <code>8002</code>.<br />
* установить в переменную окружения <code>SVACER_MPC_TOKEN</code> строку с токеном авторизации, который необходимо будет указать в клиенте MCP-сервера;<br />
* при необходимости доступа к MCP-серверу по адресу отличному от <code>localhost</code> (<code>127.0.0.1</code>) или при использовании DNS необходимо:<br />
** указать необходимый адрес/dns-имя в переменной <code>MCP_ALLOWED_HOSTS</code> в виде <code>172.17.0.1:*</code>/<code>some.domain:*</code><br />
** указать необходимый адрес/dns-имя в переменной <code><nowiki>MCP_ALLOWED_ORIGINS</nowiki></code> в виде <code><nowiki>http://172.17.0.1:*</nowiki></code>/<code><nowiki>http://some.domain:*</nowiki></code><br />
* При необходимости можно настроить логин и пароль пользователя, от имени которого mcp-сервер будет выполнять запросы к Svacer. По умолчанию: <code>admin:admin</code><br />
<br />
После запуска mcp-сервер будет доступен по адресу <code><nowiki>http://localhost:{MCP_PORT}/mcp</nowiki></code><br />
<br />
Описание других переменных доступных для конфигурации запуска ИИ-ассистента с поддержкой внешнего сервиса моделей:<br />
<pre><br />
# Bearer token for /mcp clients in HTTP mode. Generate: openssl rand -hex 32<br />
SVACER_MCP_TOKEN=<br />
<br />
# Svacer admin login and password<br />
SVACER_LOGIN=admin<br />
SVACER_PASSWORD=admin<br />
<br />
# External port that will be mapped by docker to the internal port 8000<br />
MCP_PORT=8002<br />
<br />
MCP_ALLOWED_HOSTS=172.17.0.1:*<br />
MCP_ALLOWED_ORIGINS=http://172.17.0.1:*<br />
<br />
# Svacer server (container) URL<br />
# SVACER_URL=http://svacer:8080<br />
<br />
# HTTP timeout for requests to Svacer, seconds<br />
# SVACER_TIMEOUT=30<br />
<br />
# Public URL of this MCP server (used for WWW-Authenticate, RFC 9728).<br />
# Defaults to http://localhost:<SVACER_HTTP_PORT>. Set when running behind a reverse proxy.<br />
# SVACER_MCP_RESOURCE_URL=https://mcp.example.com<br />
<br />
# Subset of tools to register (comma-separated). Unset = all 8 tools.<br />
# Available: get_projects, get_snapshots, get_warnings, get_markers,<br />
# get_project_stats, get_project_groups, get_advanced_file_preview, get_diff<br />
# SVACER_TOOLS=get_projects,get_snapshots,get_markers<br />
</pre></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Checker_edit.png&diff=3549File:Checker edit.png2026-05-22T09:03:41Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Checkers_list.png&diff=3548File:Checkers list.png2026-05-22T09:03:24Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3547Help:13-alpha new features2026-05-22T09:03:08Z<p>Mitrofanov: /* Редактирование описания детектора */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы интерфейса.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты форм интерфейса:<br />
<br />
[[File:Automigrate list rules.png|thumb|none|x400px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate log.png|thumb|none|x430px|alt=Automigrate_preview|Предпросмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты форм интерфейса.<br />
[[File:Review migration 1.png|thumb|none|x400px|alt=Review_migration_1|Шаг 1: Задание параметров миграции разметки]]<br />
[[File:Review migration 2.png|thumb|none|x425px|alt=Review_migration_2|Шаг 2: Просмотр и настройка плана миграции разметки]]<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты интерфейса.<br />
<br />
[[File:Checkers list.png|thumb|none|x400px|alt=Checker_list|Список детекторов]]<br />
[[File:Checker edit.png|thumb|none|x425px|alt=Checker_edit|Редактирование builtin-детектора]]</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3546Help:13-alpha new features2026-05-22T08:59:44Z<p>Mitrofanov: /* Миграция разметки */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы интерфейса.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты форм интерфейса:<br />
<br />
[[File:Automigrate list rules.png|thumb|none|x400px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate log.png|thumb|none|x430px|alt=Automigrate_preview|Предпросмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты форм интерфейса.<br />
[[File:Review migration 1.png|thumb|none|x400px|alt=Review_migration_1|Шаг 1: Задание параметров миграции разметки]]<br />
[[File:Review migration 2.png|thumb|none|x425px|alt=Review_migration_2|Шаг 2: Просмотр и настройка плана миграции разметки]]<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Review_migration_2.png&diff=3545File:Review migration 2.png2026-05-22T08:58:34Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Review_migration_1.png&diff=3544File:Review migration 1.png2026-05-22T08:58:18Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3543Help:13-alpha new features2026-05-22T08:58:07Z<p>Mitrofanov: /* Миграция разметки */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы интерфейса.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты форм интерфейса:<br />
<br />
[[File:Automigrate list rules.png|thumb|none|x400px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate log.png|thumb|none|x430px|alt=Automigrate_preview|Предпросмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты форм интерфейса.<br />
[[File:Review migration 1.png|thumb|none|x400px|alt=Review_migration_1|Шаг 1: Задание параметров миграции разметки]]<br />
[[File:Review migration 2.png|thumb|none|x400px|alt=Review_migration_2|Шаг 2: Просмотр и настройка плана миграции разметки]]<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3542Help:13-alpha new features2026-05-22T08:45:23Z<p>Mitrofanov: /* Настройка правил автоудаления */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы интерфейса.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты форм интерфейса:<br />
<br />
[[File:Automigrate list rules.png|thumb|none|x400px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate log.png|thumb|none|x430px|alt=Automigrate_preview|Предпросмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3541Help:13-alpha new features2026-05-22T08:44:59Z<p>Mitrofanov: /* Настройка правил автомиграциии разметки */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты форм интерфейса:<br />
<br />
[[File:Automigrate list rules.png|thumb|none|x400px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate log.png|thumb|none|x430px|alt=Automigrate_preview|Предпросмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3540Help:13-alpha new features2026-05-22T08:42:37Z<p>Mitrofanov: /* Настройка правил автомиграциии разметки */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
[[File:Automigrate list rules.png|thumb|none|x350px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate log.png|thumb|none|x400px|alt=Automigrate_preview|Предпросмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Automigrate_log.png&diff=3539File:Automigrate log.png2026-05-22T08:41:38Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3538Help:13-alpha new features2026-05-22T08:41:27Z<p>Mitrofanov: /* Настройка правил автомиграциии разметки */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
[[File:Automigrate list rules.png|thumb|none|x350px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate log.png|thumb|none|x400px|alt=Automigrate_log|Предпросмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_preview|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3537Help:13-alpha new features2026-05-22T08:38:50Z<p>Mitrofanov: /* Настройка правил автомиграциии разметки */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
[[File:Automigrate list rules.png|thumb|none|x350px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_preview|Просмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate log.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Automigrate_preview.png&diff=3536File:Automigrate preview.png2026-05-22T08:37:30Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Automigrate_create_rule.png&diff=3535File:Automigrate create rule.png2026-05-22T08:37:15Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Automigrate_list_rules.png&diff=3534File:Automigrate list rules.png2026-05-22T08:36:48Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3533Help:13-alpha new features2026-05-22T08:36:38Z<p>Mitrofanov: /* Настройка правил автомиграциии разметки */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
[[File:Automigrate list rules.png|thumb|none|x350px|alt=Automigrate_list_rules|Список правил автомиграции разметки]]<br />
[[File:Automigrate create rule.png|thumb|none|x400px|alt=Automigrate_create_rules|Создание правила автомиграции разметки]]<br />
[[File:Automigrate preview.png|thumb|none|x400px|alt=Automigrate_log|Просмотр затрагиваемых правилами веток проектов]]<br />
[[File:Automigrate log.png|thumb|none|x400px|alt=Automigrate_log|Просмотр лога автомиграции]]<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3532Help:13-alpha new features2026-05-22T08:27:42Z<p>Mitrofanov: /* Настройка правил автоудаления */</p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
[[File:Cleanup list rules.png|thumb|none|x350px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup create rules.png|thumb|none|x400px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Cleanup_create_rules.png&diff=3531File:Cleanup create rules.png2026-05-22T08:25:43Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=File:Cleanup_list_rules.png&diff=3530File:Cleanup list rules.png2026-05-22T08:25:23Z<p>Mitrofanov: </p>
<hr />
<div></div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3529Help:13-alpha new features2026-05-22T08:25:03Z<p>Mitrofanov: </p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
[[File:Cleanup_list_rules.png|thumb|none|x300px|alt=Cleanup_list_rules|Список правил автоудаления]]<br />
[[File:Cleanup_create_rules.png|thumb|none|x300px|alt=Cleanup_create_rules|Создание правила автоудаления]]<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_MCP&diff=3528Help:13-alpha MCP2026-05-22T08:18:17Z<p>Mitrofanov: </p>
<hr />
<div>== Архитектура ==<br />
[https://modelcontextprotocol.io/docs/getting-started/intro MCP] — открытый стандарт, через который LLM-клиенты (Claude Desktop, Cursor, VS Code, OpenWebUI и др.) вызывают внешние инструменты. <br />
Svacer MCP соединяет одно с другим: 8 инструментов поверх публичного REST API Svacer, которые LLM выбирает и вызывает в ответ на обычный текстовый запрос. Вместо ручной последовательности «открыть UI, найти проект, выбрать снимок, применить фильтр» достаточно сформулировать вопрос в чате, например, «сколько критических предупреждений в последнем снимке bash?», и получить ответ. Необходимые вызовы инструментов модель выполняет самостоятельно.<br />
<br />
[[File:Архитектура MCP.png|thumb|none|x800px|alt=architectureMCP|Архитектура MCP-сервера]]<br />
<br />
Поток запроса: LLM-клиент отправляет MCP-вызов через STDIO или Streamable HTTP → <code>server.py</code> передаёт его в выбранный инструмент из <code>tools/</code> → инструмент проверяет параметры и обращается к <code>api_client.py</code> → клиент получает JWT от <code>auth.py</code> (модуль автоматически обновляет токен по истечении срока действия или при ответе 401) → запрос отправляется в Svacer REST API.<br />
<br />
== Установка ==<br />
Установка Svacer MCP, подключение клиентов и конфигурация.<br />
<br />
=== Требования ===<br />
<br />
* Python 3.10+<br />
* Доступ к Svacer-серверу: URL + логин/пароль<br />
<br />
=== Режим STDIO ===<br />
Подходит для настольных клиентов: Claude Desktop, Claude Code, Cursor, VS Code.<br />
<code>git clone <nowiki>https://gitlab.ispras.ru/svacerai/mcp.git</nowiki> && cd mcp<br />
<br />
python3 -m venv .venv<br />
.venv/bin/pip install -e .<br />
<br />
cp .env.example .env<br />
# Отредактировать .env — указать URL и учётные данные Svacer<br />
<br />
# Проверить запуск (сервер ожидает данные на stdin; для выхода — Ctrl+C)<br />
.venv/bin/svacer-mcp</code><br />
После <code>pip install -e .</code> в окружении становится доступна команда <code>svacer-mcp</code> — её указывают в конфигурации клиентов ниже.<br />
<br />
=== Режим HTTP (Docker) ===<br />
Подходит для веб-клиентов (OpenWebUI) и удалённого доступа.<br />
<br />
'''Требования:''' Docker, Docker Compose.<br />
<code>cp .env.example .env<br />
<br />
# В .env обязательно задать SVACER_MCP_TOKEN — без него сервер не запускается<br />
echo "SVACER_MCP_TOKEN=$(openssl rand -hex 32)" >> .env<br />
<br />
docker compose up -d<br />
<br />
# MCP endpoint: <nowiki>http://localhost:8002/mcp</nowiki><br />
# Клиенты передают заголовок: Authorization: Bearer <SVACER_MCP_TOKEN></code><br />
Внешний порт хоста задаётся переменной <code>MCP_PORT</code> (по умолчанию <code>8002</code>), внутри контейнера сервер всегда слушает порт <code>8000</code>.<br />
<br />
=== Подключение клиентов ===<br />
<br />
==== Claude Desktop ====<br />
Файл конфигурации: <code>~/.config/Claude/claude_desktop_config.json</code> (Linux) или <code>%APPDATA%\Claude\claude_desktop_config.json</code> (Windows).<br />
<br />
Укажите '''абсолютный путь''' к <code>svacer-mcp</code> из вашего venv (<code>which svacer-mcp</code> в активированном venv или <code>/path/to/mcp/.venv/bin/svacer-mcp</code>).<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Claude Code ====<br />
<code>claude mcp add svacer \<br />
-e SVACER_URL=<nowiki>https://your-svacer.example.com</nowiki> \<br />
-e SVACER_LOGIN=your-login \<br />
-e SVACER_PASSWORD=your-password \<br />
-- /path/to/mcp/.venv/bin/svacer-mcp</code><br />
<br />
==== VS Code ====<br />
Файл <code>.vscode/mcp.json</code> в корне рабочей директории:<br />
<code>{<br />
"servers": {<br />
"svacer": {<br />
"type": "stdio",<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Cursor ====<br />
Файл <code>.cursor/mcp.json</code> в корне проекта или глобально:<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== OpenWebUI ====<br />
<br />
# Развернуть через Docker (см. «Режим HTTP» выше).<br />
# Открыть '''Settings → Tools''' (или '''Admin Panel → Settings → Tools''').<br />
# Добавить сервер:<br />
#* <code><nowiki>http://localhost:8002/mcp</nowiki></code> — если OpenWebUI работает на хосте, снаружи Docker.<br />
#* <code><nowiki>http://svacer-mcp:8000/mcp</nowiki></code> — если OpenWebUI развёрнут в той же compose-сети, что и <code>svacer-mcp</code> (имя берётся из <code>docker-compose.yml</code> → service name, порт 8000 — внутренний порт контейнера).<br />
# Тип подключения: '''MCP (Streamable HTTP)'''.<br />
# В настройках инструмента указать заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code> (значение — то же, что в <code>.env</code> сервера).<br />
# Сохранить — инструменты появятся в чате.<br />
<br />
=== Конфигурация ===<br />
{| class="wikitable"<br />
!Переменная<br />
!По умолчанию<br />
!Описание<br />
|-<br />
|<code>SVACER_URL</code><br />
|<code><nowiki>https://svacer-demo.ispras.ru</nowiki></code><br />
|URL Svacer-сервера<br />
|-<br />
|<code>SVACER_LOGIN</code><br />
|<code>admin</code><br />
|Логин<br />
|-<br />
|<code>SVACER_PASSWORD</code><br />
|<code>admin</code><br />
|Пароль<br />
|-<br />
|<code>SVACER_TIMEOUT</code><br />
|<code>30</code><br />
|Тайм-аут HTTP-запросов к Svacer, секунды<br />
|-<br />
|<code>SVACER_TRANSPORT</code><br />
|<code>stdio</code><br />
|Режим транспорта: <code>stdio</code> или <code>http</code><br />
|-<br />
|<code>SVACER_HTTP_PORT</code><br />
|<code>8000</code><br />
|TCP-порт сервера в режиме HTTP (внутри контейнера)<br />
|-<br />
|<code>SVACER_MCP_TOKEN</code><br />
|''(не задано)''<br />
|Bearer-токен для клиентов <code>/mcp</code>. Обязателен при <code>SVACER_TRANSPORT=http</code>, в режиме STDIO игнорируется. Генерация: <code>openssl rand -hex 32</code><br />
|-<br />
|<code>SVACER_MCP_RESOURCE_URL</code><br />
|<code><nowiki>http://localhost</nowiki>:<HTTP_PORT></code><br />
|Публичный URL MCP-сервера для заголовка <code>WWW-Authenticate</code> (<nowiki>RFC 9728</nowiki>). Задаётся при работе за обратным прокси<br />
|-<br />
|<code>SVACER_TOOLS</code><br />
|''(не задано)''<br />
|Список инструментов через запятую. Если не задано, регистрируются все 8<br />
|-<br />
|<code>MCP_PORT</code><br />
|<code>8002</code><br />
|Внешний порт хоста при запуске через <code>docker compose</code> (отображается на внутренний <code>SVACER_HTTP_PORT</code>)<br />
|}<br />
Переменные читаются из <code>.env</code> или из окружения. Для STDIO-клиентов их можно указать в секции <code>env</code> конфигурации клиента.<br />
<br />
==== Ограничение набора инструментов ====<br />
Чтобы запустить сервер с подмножеством инструментов (например, для уменьшения объёма контекста у модели или разграничения доступа), задайте <code>SVACER_TOOLS</code>:<br />
<code>SVACER_TOOLS=get_projects,get_snapshots,get_markers</code><br />
Допустимые имена: <code>get_projects</code>, <code>get_snapshots</code>, <code>get_warnings</code>, <code>get_markers</code>, <code>get_project_stats</code>, <code>get_project_groups</code>, <code>get_advanced_file_preview</code>, <code>get_diff</code>. Неизвестное имя в списке приводит к ошибке при запуске. Если переменная пустая или не задана, регистрируются все 8 инструментов.<br />
<br />
==== Несколько экземпляров сервера ====<br />
Параллельный запуск нескольких MCP-серверов поддерживается без ограничений.<br />
<br />
* В режиме STDIO каждая запись в конфигурации клиента описывает отдельный процесс — несколько подключений к разным экземплярам Svacer задаются простым перечислением.<br />
* В режиме HTTP запускаются независимые контейнеры на разных хост-портах: например, <code>MCP_PORT=8002</code> для одного экземпляра и <code>MCP_PORT=8003</code> для другого. Для каждого контейнера задаётся собственный <code>SVACER_MCP_TOKEN</code>.<br />
<br />
=== Безопасность ===<br />
<br />
* '''STDIO''': сервер не открывает сетевых портов и обменивается данными через стандартные потоки ввода/вывода процесса.<br />
* '''Streamable HTTP''': эндпоинт <code>/mcp</code> требует заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code>. Запросы без токена или с неверным значением получают ответ <code>401</code> и заголовок <code>WWW-Authenticate: Bearer ...</code>. Токен является разделяемым секретом и не заменяет TLS, а дополняет его: при работе за обратным прокси необходимо использовать HTTPS, а сам токен передавать только по защищённому каналу.<br />
* Без <code>SVACER_MCP_TOKEN</code> HTTP-сервер не запускается.<br />
* Учётные данные <code>admin/admin</code> предназначены только для тестового стенда. В рабочем окружении необходимо задать собственные логин и пароль через переменные окружения.<br />
* Файл <code>.env</code> не должен добавляться в систему контроля версий.<br />
<br />
==== Передача токена клиентом ====<br />
Большинство HTTP-клиентов MCP (OpenWebUI и др.) позволяют задать произвольный заголовок <code>Authorization</code> в настройках инструмента — указывается значение <code>Bearer <токен></code>. Для ручной проверки:<br />
<code>curl -H "Authorization: Bearer $SVACER_MCP_TOKEN" \<br />
<nowiki> </nowiki> -H 'Content-Type: application/json' \<br />
<nowiki> </nowiki> -H 'Accept: application/json, text/event-stream' \<br />
<nowiki> </nowiki> -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}' \<br />
<nowiki> </nowiki> <nowiki>http://localhost:8002/mcp</nowiki></code><br />
<br />
== Инструменты ==<br />
Справочник по 8 инструментам Svacer MCP. Типичный порядок вызовов: <code>get_projects</code> → <code>get_snapshots</code> → любой из аналитических инструментов.<br />
{| class="wikitable"<br />
!Инструмент<br />
!Назначение<br />
|-<br />
|<code>get_projects</code><br />
|Список проектов с ветками — точка входа<br />
|-<br />
|<code>get_snapshots</code><br />
|Снимки конкретной ветки, от нового к старому<br />
|-<br />
|<code>get_project_stats</code><br />
|Агрегированные метрики снимка: severity / review / checker<br />
|-<br />
|<code>get_markers</code><br />
|Компактный список маркеров с серверной фильтрацией<br />
|-<br />
|<code>get_warnings</code><br />
|Полные предупреждения с трассами и историей ревью<br />
|-<br />
|<code>get_diff</code><br />
|Сравнение двух снимков: new / missing / modified / matched<br />
|-<br />
|<code>get_advanced_file_preview</code><br />
|Фрагмент исходного кода вокруг строки<br />
|-<br />
|<code>get_project_groups</code><br />
|Группа проектов по имени или UUID<br />
|}<br />
<br />
=== get_projects ===<br />
Список всех проектов с ветками. Точка входа: с этого вызова начинается практически любой сценарий — он возвращает <code>project_id</code> и <code>branch_id</code>, необходимые для последующих запросов.<br />
<br />
'''Параметров нет.'''<br />
<br />
'''Вызов:'''<br />
<code>get_projects()</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"project_id": "91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
"project_name": "bash",<br />
"created": "2021-12-13T13:22:42.122456Z",<br />
"created_by": "admin",<br />
"branches": [<br />
{<br />
"branch_id": "77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
"branch_name": "master",<br />
"created": "2021-12-13T13:22:42.394812Z"<br />
}<br />
]<br />
}<br />
]</code><br />
----<br />
<br />
=== get_snapshots ===<br />
Список снимков для конкретной ветки проекта, от нового к старому.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>name_filter</code><br />
|string<br />
|нет<br />
|Подстрока или regex для фильтра по имени снимка<br />
|}<br />
'''Вызов:'''<br />
<code>get_snapshots(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4"<br />
)</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"snapshot_id": "b42cb563-86f4-4f96-900a-7782163327c9",<br />
"name": "Snapshot 2020-03-25 09:09:41 +0300",<br />
"import_time": "2020-03-25T09:09:41.837296Z",<br />
"commit_hash": null,<br />
"markers_count": 297,<br />
"link": "<nowiki>https://svacer-demo.ispras.ru/</nowiki>..."<br />
}<br />
]</code><br />
----<br />
<br />
=== get_project_stats ===<br />
Агрегированные метрики по снимку: общее количество предупреждений, распределение по критичности, по статусу ревью, по детекторам. Наиболее быстрый способ получить общую картину по проекту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_stats(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9"<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_warnings": 771,<br />
"by_severity": {<br />
"Critical": 1,<br />
"Major": 1,<br />
"Unspecified": 769<br />
},<br />
"by_review_status": {<br />
"Confirmed": 1,<br />
"False Positive": 1,<br />
"Undecided": 767,<br />
"Unclear": 1,<br />
"Won't fix": 1<br />
},<br />
"by_checker": {<br />
"PROC_USE.VULNERABLE": 337,<br />
"UNUSED_FUNC_RES.REWRITE.MINOR": 44,<br />
"UNREACHABLE_CODE": 28,<br />
"DEREF_AFTER_NULL.EX": 27,<br />
"NULL_AFTER_DEREF": 27<br />
}<br />
}</code><br />
----<br />
<br />
=== get_markers ===<br />
Компактный список маркеров с серверной фильтрацией. Основной инструмент для перечисления и обзора: его следует предпочитать <code>get_warnings</code>, когда не требуются развёрнутые поля — трассы и история ревью.<br />
<br />
По умолчанию ответ ограничен 30 маркерами и содержит компактный набор полей. Подробнее об ограничении объёма см. раздел Про объём ответа в сценариях.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора (<code>DEREF_AFTER_NULL</code>, …)<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы маркеров<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю изменений ревью<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии к маркеру<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра из веб-интерфейса Svacer<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров в ответе (по умолчанию <code>30</code>). Значение <code>0</code> снимает ограничение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|Список разрешённых полей маркера верхнего уровня. По умолчанию — компактный набор <code>id, warnClass, file, line, msg, function, review</code>. Значение <code>["*"]</code> возвращает все поля коннектора (<code>id, warnClass, file, line, msg, tool, function, mtid, review</code>, а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены). Допустим и произвольный список — например, <code>["id","warnClass"]</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_markers(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
warnClass=["PROC_USE.VULNERABLE"]<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 341,<br />
"returned_count": 30,<br />
"truncated": true,<br />
"filters_applied": {"warnClass": ["PROC_USE.VULNERABLE"]},<br />
"markers": [<br />
{<br />
"id": "e05bb35b-a95e-4eb2-85ae-3101b788f07d",<br />
"warnClass": "PROC_USE.VULNERABLE.TEMP",<br />
"file": "/.build/lib/sh/tmpfile.c",<br />
"line": 160,<br />
"msg": "Use of vulnerable function 'mktemp' at tmpfile.c:160. ...",<br />
"function": "sh_mktmpname",<br />
"review": null<br />
}<br />
]<br />
}</code><br />
<code>total_count</code> отражает количество маркеров, удовлетворяющих фильтру до применения ограничения; <code>returned_count</code> — количество маркеров, фактически содержащихся в <code>markers</code>. При <code>truncated: true</code> следует либо сузить фильтры (<code>severity</code>, <code>warnClass</code>, <code>file</code>), либо передать <code>limit=0</code> для получения полного списка. Поля <code>tool</code> и <code>mtid</code> возвращаются только при <code>fields=["*"]</code>.<br />
----<br />
<br />
=== get_warnings ===<br />
Полные предупреждения с детальной разметкой. Ответ значительно объёмнее, чем у <code>get_markers</code>, поэтому инструмент следует использовать только тогда, когда нужны поля, отсутствующие в компактной форме: <code>traces</code>, <code>review_history</code>, <code>checker_info</code>, <code>comment_history</code>.<br />
<br />
Лимит по умолчанию — 30; при включённых <code>traces</code>, <code>review_history</code> или <code>comment_history</code> он автоматически снижается до 8, поскольку такие предупреждения существенно объёмнее.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы. Активирует режим расширенных полей (лимит по умолчанию — 8)<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю ревью. Режим расширенных полей<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии. Режим расширенных полей<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество предупреждений в ответе. По умолчанию — <code>30</code>, в режиме расширенных полей — <code>8</code>. Значение <code>0</code> снимает ограничение. Явно заданное <code>limit</code> отменяет автоматическое снижение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_warnings(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
severity=["Critical"],<br />
review_history=True,<br />
traces=True<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 1,<br />
"returned_count": 1,<br />
"truncated": false,<br />
"filters_applied": {"severity": ["Critical"], "traces": true, "review_history": true},<br />
"warnings": [<br />
{<br />
"id": "a3f21c90-1d4e-4b82-9f63-7c8e5d2a1b09",<br />
"warnClass": "DEREF_AFTER_NULL.LOOP",<br />
"file": "/.build/execute_cmd.c",<br />
"line": 3327,<br />
"msg": "Possible null pointer dereference of 'l' after loop exit.",<br />
"function": "select_query",<br />
"review": {"status": "Confirmed", "severity": "Critical"},<br />
"review_history": [{"status": "Confirmed", "changed_by": "admin", "changed_at": "2021-12-13T14:00:00Z"}],<br />
"traces": [{"file": "/.build/execute_cmd.c", "line": 3320, "msg": "Loop starts here; 'l' may exhaust the list."}]<br />
}<br />
]<br />
}</code><br />
----<br />
<br />
=== get_diff ===<br />
Сравнение двух снимков. Категории располагаются под ключом <code>markers</code>: <code>new_markers</code> (появилось в новом снимке), <code>missing_markers</code> (исчезло из нового), <code>modified_markers</code> (тот же идентификатор, изменился контекст), <code>matched_markers</code> (совпало в обоих). Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно UUID снимков.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>base_snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|Старый снимок<br />
|-<br />
|<code>head_snapshot_id</code><br />
|string (UUID)<br />
|нет<br />
|Новый снимок; если не указан, сравнение выполняется с предыдущим по времени<br />
|-<br />
|<code>level</code><br />
|int<br />
|нет<br />
|<code>0</code> — только статистика; <code>1</code> — статистика и идентификаторы маркеров; <code>2</code> — полные маркеры по категориям<br />
|-<br />
|<code>checker_info</code><br />
|bool<br />
|нет<br />
|Метаданные детекторов для маркеров (только при <code>level >= 2</code>)<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров '''на каждую категорию''' при <code>level >= 2</code>. По умолчанию — <code>20</code>, значение <code>0</code> снимает ограничение. Параметр игнорируется при <code>level < 2</code><br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code>/<code>get_warnings</code>. Применяется к маркерам внутри категорий при <code>level >= 2</code><br />
|}<br />
'''Вызов (<code>level=0</code>):'''<br />
<code>get_diff(<br />
base_snapshot_id="72b3df7b-c15a-4e3d-8f92-a041dc6e5b87",<br />
head_snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
level=0<br />
)</code><br />
'''Ответ (<code>level=0</code>):'''<br />
<code>{<br />
"stats": {<br />
"context1": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-20 ..."},<br />
"context2": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-25 ..."},<br />
"scope": ["NEW", "MISSING", "MATCHED", "MODIFIED"],<br />
"new": 9,<br />
"missing": 12,<br />
"modified": 98,<br />
"matched": 187<br />
}<br />
}</code><br />
'''Ответ (<code>level=2</code>)''' — каждая категория внутри <code>markers</code> оформляется и ограничивается независимо:<br />
<code>{<br />
"stats": {"new": 50, "missing": 5, "modified": 0, "matched": 187},<br />
"markers": {<br />
"new_markers": {<br />
"total_count": 50,<br />
"returned_count": 20,<br />
"truncated": true,<br />
"markers": [<br />
{"id": "a3f21c90-...", "warnClass": "DEREF_AFTER_NULL.LOOP", "file": "...", "line": 3327, "msg": "...", "function": "select_query", "review": null}<br />
]<br />
},<br />
"missing_markers": {"total_count": 5, "returned_count": 5, "truncated": false, "markers": [...]},<br />
"modified_markers": {"total_count": 0, "returned_count": 0, "truncated": false, "markers": []},<br />
"matched_markers": {"total_count": 187, "returned_count": 20, "truncated": true, "markers": [...]}<br />
}<br />
}</code><br />
Если требуется полное содержимое категории, следует увеличить <code>limit</code> либо запросить нужные идентификаторы отдельным вызовом <code>get_markers</code>. Маркеры внутри категорий проходят ту же компактную обработку, что и в <code>get_warnings</code>: значение <code>fields=["*"]</code> возвращает фиксированный набор полей коннектора, а не произвольные «сырые» поля API.<br />
----<br />
<br />
=== get_advanced_file_preview ===<br />
Фрагмент исходного кода из снимка вокруг указанной строки. Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно идентификатора снимка и пути к файлу.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>file_path</code><br />
|string<br />
|да<br />
|Путь к файлу в том виде, в котором его возвращают <code>get_markers</code> и <code>get_warnings</code><br />
|-<br />
|<code>line</code><br />
|int<br />
|нет<br />
|Центральная строка, нумерация с 1 (по умолчанию <code>1</code>)<br />
|-<br />
|<code>before</code><br />
|int<br />
|нет<br />
|Количество строк до центральной (по умолчанию <code>0</code>)<br />
|-<br />
|<code>after</code><br />
|int<br />
|нет<br />
|Количество строк после центральной (по умолчанию <code>99999</code> — до конца файла)<br />
|}<br />
'''Вызов:'''<br />
<code>get_advanced_file_preview(<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
file_path="/.build/execute_cmd.c",<br />
line=3327,<br />
before=10,<br />
after=10<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"line": 3327,<br />
"content": " for (l = list; l && --reply; l = l->next)\n\t;\n return (l->word->word);\n",<br />
"total_lines": 6082<br />
}</code><br />
----<br />
<br />
=== get_project_groups ===<br />
Получить группу проектов по имени или UUID. Группы объединяют проекты в логические блоки — например, по команде или продукту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>name_or_id</code><br />
|string<br />
|да<br />
|Имя группы или её UUID<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_groups(name_or_id="Linux Tools")</code><br />
'''Ответ:'''<br />
<code>{<br />
"project_group_id": "c4f8a2d1-3b7e-4f90-82ac-1d5e8f2b6c04",<br />
"project_group_name": "Linux Tools",<br />
"projects": [<br />
{"id": "91630e84-db2f-4d8c-8716-68b7fdf17a66", "name": "bash"},<br />
{"id": "d3a17f52-...", "name": "coreutils"}<br />
]<br />
}</code><br />
<code>projects[].id</code> — это <code>project_id</code>, который далее передаётся в <code>get_snapshots</code>. Группы и проекты — разные сущности; идентификатор группы и идентификатор проекта не взаимозаменяемы.<br />
<br />
== Примеры сценариев ==<br />
Приведённые ниже запросы выполнены на демонстрационном стенде <code>svacer-demo.ispras.ru</code> с использованием OpenWebUI и модели <code>qwen3-coder:30b</code>. В любом другом MCP-клиенте с моделью достаточной мощности порядок вызовов будет аналогичным.<br />
<br />
=== Про объём ответа ===<br />
<code>get_markers</code>, <code>get_warnings</code> и <code>get_diff(level=2)</code> по умолчанию ограничивают объём ответа, чтобы не перегружать контекст модели:<br />
<br />
* <code>get_markers</code> и <code>get_warnings</code> — 30 маркеров по умолчанию. Если у <code>get_warnings</code> включены <code>traces</code>, <code>review_history</code> или <code>comment_history</code>, лимит снижается до 8, поскольку такие маркеры значительно объёмнее.<br />
* <code>get_diff(level=2)</code> — 20 маркеров на каждую категорию внутри <code>markers</code> (<code>new_markers</code>/<code>missing_markers</code>/<code>modified_markers</code>/<code>matched_markers</code>).<br />
<br />
В ответе присутствуют поля <code>total_count</code>, <code>returned_count</code>, <code>truncated</code>. При <code>truncated: true</code> есть два варианта действий: сузить фильтр (<code>severity</code>, <code>warnClass</code>, <code>file</code>) либо явно увеличить <code>limit</code> (значение <code>limit=0</code> полностью снимает ограничение).<br />
<br />
Поле <code>fields</code> определяет, какие ключи маркера возвращаются. По умолчанию применяется компактный набор <code>id, warnClass, file, line, msg, function, review</code> (а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены логическими флагами и пришли с сервера). Для полного маркера со всеми служебными ключами — <code>fields=["*"]</code>. Для произвольной выборки — список полей верхнего уровня, например <code>fields=["id","warnClass"]</code>. Поле <code>review</code> — объект <code>{status, severity, action}</code>; вложенные ключи в <code>fields</code> не поддерживаются, поэтому объект <code>review</code> запрашивается целиком.<br />
<br />
=== Перечислить все проекты ===<br />
<blockquote>Какие проекты есть в Svacer?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
<br />
'''Ответ модели:'''<blockquote>В Svacer доступно 6 проектов: bash, openssl, paho.mqtt.c, coturn, zstd, darpa. У каждого — одна ветка <code>master</code>.</blockquote><br />
<br />
=== Посмотреть снимки проекта ===<br />
<blockquote>Какие снимки есть у paho.mqtt.c? Самый свежий когда?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code> — найти <code>project_id</code> и <code>branch_id</code><br />
# <code>get_snapshots(project_id=..., branch_id=...)</code><br />
<br />
'''Ответ модели:'''<blockquote>У paho.mqtt.c 3 снимка. Самый свежий — «Snapshot 2020-03-25 09:09:41 +0300» (297 маркеров). Предыдущий — 20 марта (306 маркеров).</blockquote>Поле <code>commit_hash</code> может принимать значение <code>null</code>, если проект не сохраняет хэш коммита в <code>custom_properties</code>. Имена снимков произвольны: одни проекты записывают в имя дату, другие — коммит, третьи — свободный текст.<br />
<br />
=== Сводка по проекту ===<br />
<blockquote>Что в bash в последнем снимке? Сколько всего предупреждений, есть ли критические, какие топ-детекторы?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots(project_id, branch_id)</code> — взять последний снимок<br />
# <code>get_project_stats(project_id, branch_id, snapshot_id)</code><br />
<br />
'''Ответ модели:'''<blockquote>В последнем снимке bash содержится 771 предупреждение:<br />
<br />
* Критических: 1 (Confirmed)<br />
* Major: 1 (Won't fix)<br />
* Остальные: 769 (Unspecified — не ревьюились)<br />
<br />
Топ-детекторы по количеству:<br />
<br />
# <code>PROC_USE.VULNERABLE</code> — 337<br />
# <code>UNUSED_FUNC_RES.REWRITE.MINOR</code> — 44<br />
# <code>UNREACHABLE_CODE</code> — 28<br />
# <code>DEREF_AFTER_NULL.EX</code> — 27<br />
# <code>NULL_AFTER_DEREF</code> — 27<br />
</blockquote><code>Unspecified</code> в <code>by_severity</code> — маркеры без ручного ревью, а не «низкий приоритет». Поле <code>by_checker</code> не сортируется, на большом снимке оно может содержать более 100 ключей — чтобы получить именно топ-N, следует явно сформулировать запрос: «топ-5 детекторов».<br />
<br />
=== Тренд по нескольким снимкам ===<br />
<blockquote>Как у openssl менялось число предупреждений за последние пять снимков? Покажи таблицей.</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — взять список<br />
# <code>get_project_stats()</code> × 5 — по каждому из последних пяти снимков<br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
{| class="wikitable"<br />
|+<br />
!Снимок<br />
!Дата<br />
!Всего<br />
|-<br />
|2020-04-30 05:49<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:29<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:08<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:48<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:22<br />
|30.04.2020<br />
|1252<br />
|}<br />
</blockquote><br />
На демонстрационном стенде указанные пять снимков openssl импортированы с интервалом в 20 минут одного дня и полностью идентичны — поэтому динамика отсутствует. На реальном проекте с историей релизов значения будут изменяться.<br />
<br />
=== Найти срабатывания конкретного детектора ===<br />
<blockquote>Где в bash срабатывает PROC_USE.VULNERABLE? Покажи список — файл, строка, что именно ругается. Достаточно первых десяти.</blockquote>'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code><br />
# <code>get_markers(warnClass=["PROC_USE.VULNERABLE"])</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
# <code>/.build/lib/sh/tmpfile.c:160</code> — <code>mktemp()</code>, race condition. Рекомендуется <code>mkstemp()</code>.<br />
# <code>/.build/lib/readline/shell.c:151</code> — <code>getenv()</code>, значение может быть подменено.<br />
# <code>/.build/shell.c:415</code> — <code>getenv()</code> в <code>main()</code>.<br />
# <code>/.build/lib/readline/complete.c:1516</code> — <code>getenv()</code>.<br />
# <code>/.build/lib/sh/eaccess.c:115</code> — <code>strcat()</code>, рекомендуется <code>strncat()</code>. …<br />
</blockquote><br />
Фильтр <code>warnClass=["PROC_USE.VULNERABLE"]</code> охватывает все подклассы: <code>PROC_USE.VULNERABLE.TEMP</code>, <code>.GETENV</code>, <code>.STRCAT</code> и т. д. — всего 341 маркер. Несколько значений в одном параметре трактуются как логическое «ИЛИ»: <code>severity=["Critical","Major"]</code> возвращает маркеры обеих категорий.<br />
<br />
В ответе будет <code>total_count: 341, returned_count: 30, truncated: true</code> — это ожидаемое поведение. Модель видит общий объём по <code>total_count</code> и при необходимости сужает запрос или вызывает <code>get_markers(..., limit=0)</code>, чтобы получить полный список.<br />
<br />
=== Сравнить два снимка ===<br />
<blockquote>Возьми два последних снимка paho.mqtt.c — что между ними изменилось? Сколько новых предупреждений, сколько починили?</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — два последних<br />
# <code>get_diff(base_snapshot_id="72b3df7b-...", head_snapshot_id="b42cb563-...", level=0)</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote>Между двумя последними снимками paho.mqtt.c:<br />
<br />
* Новых: 12<br />
* Удалённых: 13<br />
* Изменённых: 99<br />
* Совпадающих: 185<br />
<br />
Удалено несколько больше, чем добавлено — общая картина практически не изменилась.</blockquote><br />
<br />
Категория <code>modified</code> — маркер, присутствующий в обоих снимках, у которого изменилось окружение (номер строки, контекст функции). Это не новая ошибка. На больших проектах рекомендуется начинать с <code>level=0</code> для получения статистики, при необходимости использовать <code>level=1</code> (только идентификаторы маркеров) и затем точечно вызывать <code>get_markers</code> с нужными фильтрами.<br />
<br />
<code>level=2</code> возвращает полные маркеры по категориям, причём каждая категория по умолчанию ограничена 20 маркерами. Категории располагаются внутри <code>markers</code>: <code>new_markers</code>, <code>missing_markers</code>, <code>modified_markers</code>, <code>matched_markers</code>. Структура ответа в JSON: <code><nowiki>{"markers": {"new_markers": {"total_count": N, "returned_count": ..., "truncated": ..., "markers": [...]}, ...}}</nowiki></code>. Если требуется полное содержимое категории, следует увеличить <code>limit</code> или выполнить отдельный вызов <code>get_markers</code> по нужным идентификаторам.<br />
<br />
=== Разобрать конкретное предупреждение ===<br />
<blockquote>В bash есть один подтверждённый критикал — что-то про разыменование указателя. Покажи код вокруг этого места и объясни в чём проблема.</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code> → <code>get_snapshots()</code> — найти снимок bash<br />
# <code>get_markers(severity=["Critical"], review=["Confirmed"])</code><br />
# <code>get_advanced_file_preview(file_path="/.build/execute_cmd.c", line=3327, before=10, after=10)</code><br />
<br />
'''Ответ модели:<blockquote>Маркер <code>DEREF_AFTER_NULL.LOOP</code> в функции <code>select_query()</code>, строка 3327:<br />
<code>for (l = list; l && --reply; l = l->next)<br />
<br />
;<br />
<br />
return (l->word->word); /* l может быть NULL после выхода из цикла */</code><br />
<br />
Если список заканчивается раньше, чем <code>reply</code> обнуляется, <code>l</code> станет <code>NULL</code> на последнем <code>l->next</code>, и следующий <code>l->word->word</code> — разыменование нулевого указателя.</blockquote><code>file_path</code> должен точно совпадать со значением, возвращённым маркером, включая ведущий префикс <code>/.build/...</code>. Это путь внутри сборочной директории Svacer, а не путь в исходном репозитории; соответствие в репозитории определяется по имени файла.<br />
<br />
Для одиночной разметки удобно сразу запрашивать полный маркер с трассами: <code>get_markers(..., severity=["Critical"], review=["Confirmed"], traces=True, checker_info=True)</code>. Флаги <code>traces</code> и <code>checker_info</code> указывают серверу включить соответствующие поля в ответ; в выдаче они сохраняются и при значении <code>fields</code> по умолчанию. Значение <code>fields=["*"]</code> требуется лишь в том случае, когда дополнительно нужны <code>tool</code> и <code>mtid</code> — служебные ключи, исключённые из компактного набора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3527Help:13-alpha new features2026-05-22T08:16:22Z<p>Mitrofanov: </p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примерами разметки одиночного маркера и группы маркеров с помощью LLM:<br />
[https://svacer.ispras.ru/video/ai_review.mp4 ai_review.mp4]<br />
[https://svacer.ispras.ru/video/group_ai_review.mp4 group_ai_review.mp4]<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
[https://svacer.ispras.ru/video/mcp-usage.mp4 mcp-usage.mp4]<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
[https://svacer.ispras.ru/video/path-modification.mp4 path-modification.mp4]<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_introduction&diff=3526Help:13-alpha introduction2026-05-21T15:49:08Z<p>Mitrofanov: </p>
<hr />
<div>Тестовый релиз предназначен для демонстрации и тестирования новых функций Svacer<br />
<br />
Из основных новых функций, которые включены в тестовый релиз, а также которые планируется к выпуску в основном релизе Svacer v.13, можно выделить:<br />
<br />
# Validation server для интеграции с LLM.<br />
# MCP-сервер (поддержка FastMCP).<br />
# Настройка в UI правил автоудаления неиспользуемых снимков, пустых веток и проектов (cleanup).<br />
# Настройка в UI правил автомиграции разметки.<br />
# Перенос в UI функционала CLI-утилиты Pfixer для изменения путей к исходным файлам в снимке.<br />
# Перенос в UI функционала CLI-утилиты Reviewer для миграции разметки.<br />
# Возможность редактирования в Svacer описаний детекторов (параметры Severity, Reliability, CWE и др.).<br />
# Функции, не включенные в тестовый релиз:<br />
#* Расширение для VSCode с поддержкой Language Server, которое позволит:<br />
#** выполнять маппинг маркеров на код в локальном репозитории пользователя;<br />
#** вносить исправления в исходный код локального репозитория;<br />
#** выполнять фильтрацию и разметку маркеров;<br />
#** работать в онлайн и оффлайн режиме, используя snap-файл с сохранением разметки внутрь snap-файла;<br />
#** использовать language server для snap-файлов и сервера.<br />
#* Возможность указания типа комментария у маркера (внутренний или публичный). Внутренний комментарий не будет выгружаться в PDF-отчет.<br />
#* Настройка фильтрации комментариев для выгрузки в PDF-отчет.<br />
#* Отчет '''Тренды''' для графического отображения изменений по маркерам в снимках одной ветки проекта, с возможностью гибкой фильтрации, сортировки и построения множества графиков с разными фильтрами на одной странице.<br />
В разделах документации для тестового релиза представлена следующая краткая информация по:<br />
<br />
* установке тестового релиза;<br />
* настройке Validation server и подключению к нему LLM;<br />
* развертыванию Svacer MCP, его конфигурации и подключению клиентов.<br />
* описанию тулов MCP;<br />
* описанию сценариев использования MCP;<br />
* обзор некоторых новых функций, включая краткие видео-инструкции по их использованию.<br />
<br />
<br />
'''Ждем обратной связи!''' <br />
<br />
Это позволит нам выпустить основной релиз Svacer с доработанными в соответствии с вашими пожеланиями функциями.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_introduction&diff=3521Help:13-alpha introduction2026-05-21T15:07:31Z<p>Mitrofanov: </p>
<hr />
<div>Тестовый релиз предназначен для демонстрации и тестирования новых функций Svacer<br />
<br />
Из основных новых функций, которые включены в тестовый релиз, а также которые планируется к выпуску в основном релизе Svacer v.13, можно выделить:<br />
<br />
# Validation server для интеграции с LLM.<br />
# MCP-сервер (поддержка FastMCP).<br />
# Настройка в UI правил автоудаления неиспользуемых снимков, пустых веток и проектов (cleanup).<br />
# Настройка в UI правил автомиграции разметки.<br />
# Перенос в UI функционала CLI-утилиты Pfixer для изменения путей к исходным файлам в снимке.<br />
# Перенос в UI функционала CLI-утилиты Reviewer для миграции разметки.<br />
# Возможность редактирования в Svacer описаний детекторов (параметры Severity, Reliability, CWE и др.).<br />
# Функции, не включенные в тестовый релиз:<br />
#* Расширение для VSCode с поддержкой Language Server, которое позволит:<br />
#** выполнять маппинг маркеров на код в локальном репозитории пользователя;<br />
#** вносить исправления в исходный код локального репозитория;<br />
#** выполнять фильтрацию и разметку маркеров;<br />
#** работать в онлайн и оффлайн режиме, используя snap-файл с сохранением разметки внутрь snap-файла;<br />
#** использовать language server для snap-файлов и сервера.<br />
#* Возможность указания типа комментария у маркера (внутренний или публичный). Внутренний комментарий не будет выгружаться в PDF-отчет.<br />
#* Настройка фильтрации комментариев для выгрузки в PDF-отчет.<br />
#* Отчет '''Тренды''' для графического отображения изменений по маркерам в снимках одной ветки проекта, с возможностью гибкой фильтрации, сортировки и построения множества графиков с разными фильтрами на одной странице.<br />
В разделах документации для тестового релиза представлена следующая краткая информация по:<br />
<br />
* установке тестового релиза;<br />
* настройке Validation server и подключению к нему LLM;<br />
* развертыванию Svacer MCP, его конфигурации и подключению клиентов.<br />
* описанию тулов MCP;<br />
* описанию сценариев использования MCP;<br />
* обзор некоторых новых функций, включая краткие видео-инструкции по их использованию.<br />
<br />
<br />
'''Ждем обратной связи!''' <br />
<br />
Это позволит нам выпустить основной релиз Svacer с доработанными в соответствии с Вашими пожеланиями функциями.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3520Help:13-alpha new features2026-05-21T15:06:56Z<p>Mitrofanov: </p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примером разметки одиночного маркера и группы маркеров с помощью LLM:<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3519Help:13-alpha new features2026-05-21T15:06:31Z<p>Mitrofanov: </p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примером разметки одиночного маркера и группы маркеров с помощью LLM:<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления неиспользуемых снимков, пустых веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты '''Pfixer''' теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты '''Reviewer''' теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя, а также после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом '''Администрирование сервера'''.<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin(Svace) детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_introduction&diff=3518Help:13-alpha introduction2026-05-21T15:04:35Z<p>Mitrofanov: </p>
<hr />
<div>Тестовый релиз предназначен для демонстрации и тестирования новых функций Svacer<br />
<br />
Из основных новых функций, которые включены в тестовый релиз, а также которые планируется к выпуску в основном релизе Svacer v.13, можно выделить:<br />
<br />
# Validation server для интеграции с LLM.<br />
# MCP-сервер (поддержка FastMCP).<br />
# Настройка в UI правил автоудаления неиспользуемых снимков, пустых веток и проектов (cleanup).<br />
# Настройка в UI правил автомиграции разметки.<br />
# Перенос в UI функционала CLI-утилиты Pfixer для изменения путей к исходным файлам в снимке.<br />
# Перенос в UI функционала CLI-утилиты Reviewer для миграции разметки.<br />
# Возможность редактирования в Svacer описаний детекторов (параметры Severity, Reliability, CWE и др.).<br />
# Функции, не включенные в тестовый релиз:<br />
#* Расширение для VSCode с поддержкой Language Server, которое позволит:<br />
#** выполнять маппинг маркеров на код в локальном репозитории пользователя;<br />
#** вносить исправления в исходный код локального репозитория;<br />
#** выполнять фильтрацию и разметку маркеров;<br />
#** работать в онлайн и оффлайн режиме, используя snap-файл с сохранением разметки внутрь snap-файла;<br />
#** использовать language server для snap-файлов и сервера.<br />
#* Возможность указания типа комментария у маркера (внутренний или публичный). Внутренний комментарий не будет выгружаться в PDF-отчет.<br />
#* Настройка фильтрации комментариев для выгрузки в PDF-отчет.<br />
#* Отчет "Тренды" для графического отображения изменений по маркерам в снимках одной ветки проекта, с возможностью гибкой фильтрации, сортировки и построения множества графиков с разными фильтрами на одной странице.<br />
В разделах документации для тестового релиза представлена следующая краткая информация по:<br />
<br />
* установке тестового релиза;<br />
* настройке Validation server и подключению к нему LLM;<br />
* развертыванию Svacer MCP, его конфигурации и подключению клиентов.<br />
* описанию тулов MCP;<br />
* описанию сценариев использования MCP;<br />
* обзор некоторых новых функций, включая краткие видео-инструкции по их использованию.<br />
<br />
<br />
'''Ждем обратной связи!''' <br />
<br />
Это позволит нам выпустить основной релиз Svacer с доработанными в соответствии с Вашими пожеланиями функциями.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_introduction&diff=3517Help:13-alpha introduction2026-05-21T14:59:10Z<p>Mitrofanov: </p>
<hr />
<div>Тестовый релиз предназначен для демонстрации и тестирования новых функций Svacer<br />
<br />
Из основных новых функций, которые включены в тестовый релиз, а также которые планируется к выпуску в основном релизе Svacer v.13, можно выделить:<br />
<br />
# Validation server для интеграции с LLM.<br />
# MCP-сервер (поддержка FastMCP).<br />
# Настройка в UI правил автоудаления неиспользуемых снимков, пустых веток и проектов (cleanup).<br />
# Настройка в UI правил автомиграции разметки.<br />
# Перенос в UI функционала CLI-утилиты Pfixer для изменения путей к исходным файлам в снимке.<br />
# Перенос в UI функционала CLI-утилиты Reviewer для миграции разметки.<br />
# Возможность редактирования в Svacer описаний детекторов (параметры Severity, Reliability, CWE и др.).<br />
# Функции, не включенные в тестовый релиз:<br />
#* Расширение для VSCode с поддержкой Language Server, которое позволит:<br />
#** выполнять маппинг маркеров на код в локальном репозитории пользователя;<br />
#** вносить исправления в исходный код локального репозитория;<br />
#** выполнять фильтрацию и разметку маркеров;<br />
#** работать в онлайн и оффлайн режиме, используя snap-файл с сохранением разметки внутрь snap-файла;<br />
#** использовать language server для snap-файлов и сервера.<br />
#* Возможность указания типа комментария у маркера (внутренний или публичный). Внутренний комментарий не будет выгружаться в PDF-отчет.<br />
#* Настройка фильтрации комментариев для выгрузки в PDF-отчет.<br />
#* Отчет "Тренды" для графического отображения изменений по маркерам в снимках одной ветки проекта, с возможностью гибкой фильтрации, сортировки и построения множества графиков с разными фильтрами на одной странице.<br />
В разделах документации для тестового релиза представлена следующая краткая информация по:<br />
<br />
* установке тестового релиза;<br />
* настройке Validation server и подключению к нему LLM;<br />
* развертыванию Svacer MCP, его конфигурации и подключению клиентов.<br />
* описанию тулов MCP;<br />
* описанию сценариев использования MCP;<br />
* обзор некоторых новых функций, включая краткие видео-инструкции по их использованию.<br />
<br />
'''Ждем обратной связи! Это позволит нам выпустить основной релиз Svacer с доработанными в соответствии с Вашими пожеланиями функциями.'''</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_introduction&diff=3516Help:13-alpha introduction2026-05-21T14:58:26Z<p>Mitrofanov: </p>
<hr />
<div>Тестовый релиз предназначен для демонстрации и тестирования новых функций Svacer<br />
<br />
Из основных новых функций, которые включены в тестовый релиз, а также которые планируется к выпуску в основном релизе Svacer v.13, можно выделить:<br />
<br />
# Validation server для интеграции с LLM.<br />
# MCP-сервер (поддержка FastMCP).<br />
# Настройка в UI правил автоудаления неиспользуемых снимков, пустых веток и проектов (cleanup).<br />
# Настройка в UI правил автомиграции разметки.<br />
# Перенос в UI функционала CLI-утилиты Pfixer для изменения путей к исходным файлам в снимке.<br />
# Перенос в UI функционала CLI-утилиты Reviewer для миграции разметки.<br />
# Возможность редактирования в Svacer описаний детекторов (параметры Severity, Reliability, CWE и др.).<br />
# Функции, не включенные в тестовый релиз:<br />
#* Расширение для VSCode с поддержкой Language Server, которое позволит:<br />
#** выполнять маппинг маркеров на код в локальном репозитории пользователя;<br />
#** вносить исправления в исходный код локального репозитория;<br />
#** выполнять фильтрацию и разметку маркеров;<br />
#** работать в онлайн и оффлайн режиме, используя snap-файл с сохранением разметки внутрь snap-файла;<br />
#** использовать language server для snap-файлов и сервера.<br />
#* Возможность указания типа комментария у маркера (внутренний или публичный). Внутренний комментарий не будет выгружаться в PDF-отчет.<br />
#* Настройка фильтрации комментариев для выгрузки в PDF-отчет.<br />
#* Отчет "Тренды" для графического отображения изменений по маркерам в снимках одной ветки проекта, с возможностью гибкой фильтрации, сортировки и построения множества графиков с разными фильтрами на одной странице.<br />
В разделах документации для тестового релиза представлена следующая краткая информация по:<br />
<br />
* установке тестового релиза;<br />
* настройке Validation server и подключению к нему LLM;<br />
* развертыванию Svacer MCP, его конфигурации и подключению клиентов.<br />
* описанию тулов MCP;<br />
* описанию сценариев использования MCP;<br />
* обзор некоторых новых функций, включая краткие видео-инструкции по их использованию.<br />
<br />
Ждем Вашей обратной связи! Это позволит нам выпустить основной релиз Svacer с доработанными в соответствии с Вашими пожеланиями функциями.<br />
'''Ждем Вашей обратной связи! Это позволит нам выпустить основной релиз Svacer с доработанными в соответствии с Вашими пожеланиями функциями.'''</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_introduction&diff=3515Help:13-alpha introduction2026-05-21T14:58:01Z<p>Mitrofanov: </p>
<hr />
<div>Тестовый релиз предназначен для демонстрации и тестирования новых функций Svacer<br />
<br />
Из основных новых функций, которые включены в тестовый релиз, а также которые планируется к выпуску в основном релизе Svacer v.13, можно выделить:<br />
<br />
# Validation server для интеграции с LLM.<br />
# MCP-сервер (поддержка FastMCP).<br />
# Настройка в UI правил автоудаления неиспользуемых снимков, пустых веток и проектов (cleanup).<br />
# Настройка в UI правил автомиграции разметки.<br />
# Перенос в UI функционала CLI-утилиты Pfixer для изменения путей к исходным файлам в снимке.<br />
# Перенос в UI функционала CLI-утилиты Reviewer для миграции разметки.<br />
# Возможность редактирования в Svacer описаний детекторов (параметры Severity, Reliability, CWE и др.).<br />
# Функции, не включенные в тестовый релиз:<br />
#* Расширение для VSCode с поддержкой Language Server, которое позволит:<br />
#** выполнять маппинг маркеров на код в локальном репозитории пользователя;<br />
#** вносить исправления в исходный код локального репозитория;<br />
#** выполнять фильтрацию и разметку маркеров;<br />
#** работать в онлайн и оффлайн режиме, используя snap-файл с сохранением разметки внутрь snap-файла;<br />
#** использовать language server для snap-файлов и сервера.<br />
#* Возможность указания типа комментария у маркера (внутренний или публичный). Внутренний комментарий не будет выгружаться в PDF-отчет.<br />
#* Настройка фильтрации комментариев для выгрузки в PDF-отчет.<br />
#* Отчет "Тренды" для графического отображения изменений по маркерам в снимках одной ветки проекта, с возможностью гибкой фильтрации, сортировки и построения множества графиков с разными фильтрами на одной странице.<br />
В разделах документации для тестового релиза представлена следующая краткая информация по:<br />
<br />
* установке тестового релиза;<br />
* настройке Validation server и подключению к нему LLM;<br />
* развертыванию Svacer MCP, его конфигурации и подключению клиентов.<br />
* описанию тулов MCP;<br />
* описанию сценариев использования MCP;<br />
* обзор некоторых новых функций, включая краткие видео-инструкции по их использованию.<br />
<br />
Ждем Вашей обратной связи! Это позволит нам выпустить основной релиз Svacer с доработанными в соответствии с Вашими пожеланиями функциями.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Svacer&diff=3513Svacer2026-05-21T12:35:34Z<p>Mitrofanov: </p>
<hr />
<div>Svacer — сервер для хранения и обработки результатов статического анализа. Поддерживает импорт результатов анализа из [https://svace.ispras.ru Svace] напрямую и из прочих анализаторов через формат [[Help:Sarif|SARIF]].<br />
<br />
=== Документация ===<br />
Version 12.x.x<br />
# [[Help:Introduction|Введение]]<br />
# [[Help:Installation|Установка и обновление]]<br />
# [[Help:Configuration|Настройка сервера]]<br />
# [[Help:Import from Svace|Импорт из Svace]]<br />
# [[Help:Backup|Резервное копирование]]<br />
# [[Help:UI manual|Использование веб-интерфейса]]<br />
# [[Help:Public API|Public REST API]]<br />
# [[Help:CLI|CLI]]<br />
# [[LDAP configuration|LDAP]]<br />
# [[OIDC|OpenID Connect]]<br />
# [[Help:Sarif|SARIF]]<br />
# [[Help:Statistics|Статистика]]<br />
# [[Help:Match|Механизмы сопоставления предупреждений и переноса разметки]]<br />
# [[Help:XSvacer|XSvacer — расширение функциональности Svacer]]<br />
# [[Help:Utils|Дополнительные утилиты]]<br />
# [[Metrics|Prometheus-метрики]]<br />
# [[Pipelines|Примеры пайплайнов]]<br />
# [[Notifications|Уведомления]]<br />
Version test build от 20.05.2026<br />
# [[Help:Test build introduction|Введение]]<br />
# Установка test bulld<br />
# [[Help:Test_build_MCP|MCP-сервер]]<br />
# [[Help:Test_build_new_features|Обзор новой функциональности]]<br />
<br />
=== Релизы ===<br />
Также доступны в виде docker-образа на [https://hub.docker.com/r/ispras/svacer docker hub] и как пакеты в [[Help:Installation#Установка и запуск из deb/rpm пакета|репозиториях]]<br />
<br />
{| class="wikitable"<br />
! version !! distrib !! linux bin !! windows bin !! deb/rpm !! doc<br />
!svace checkers version<br />
|-<br />
| 12.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-linux.tar.gz svacer-12-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-windows.zip svacer-12-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer_12.0-1_amd64.deb svacer_12.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12.0-1.x86_64.rpm svacer-12.0-1.x86_64.rpm]<br />
| [[Changelog#Release 12-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|5.0.251220<br />
|-<br />
| 12.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-linux.tar.gz svacer-12-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-windows.zip svacer-12-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer_12.0-0_amd64.deb svacer_12.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12.0-0.x86_64.rpm svacer-12.0-0.x86_64.rpm]<br />
| [[Changelog#Release 12-0-0|Changelog]]<br />[[Release notes 12-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|4.0.251120<br />
|-<br />
| 11.2.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-linux.tar.gz svacer-11-2-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-windows.zip svacer-11-2-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer_11.2-0_amd64.deb svacer_11.2-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11.2-0.x86_64.rpm svacer-11.2-0.x86_64.rpm]<br />
| [[Changelog#Release 11-2-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.1.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-linux.tar.gz svacer-11-1-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-windows.zip svacer-11-1-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer_11.1-0_amd64.deb svacer_11.1-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11.1-0.x86_64.rpm svacer-11.1-0.x86_64.rpm]<br />
| [[Changelog#Release 11-1-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-linux.tar.gz svacer-11-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-windows.zip svacer-11-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer_11.0-0_amd64.deb svacer_11.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11.0-0.x86_64.rpm svacer-11.0-0.x86_64.rpm]<br />
| [[Changelog#Release 11-0-0|Changelog]]<br />[[Release notes 11-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 10.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-linux.tar.gz svacer-10-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-windows.zip svacer-10-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer_10.0-1_amd64.deb svacer_10.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10.0-1.x86_64.rpm svacer-10.0-1.x86_64.rpm]<br />
| [[Changelog#Release 10-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 10.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-linux.tar.gz svacer-10-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-windows.zip svacer-10-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer_10.0-0_amd64.deb svacer_10.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10.0-0.x86_64.rpm svacer-10.0-0.x86_64.rpm]<br />
| [[Changelog#Release 10-0-0|Changelog]]<br />[[Release notes 10-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 9.0.2<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9-0-2.zip svacer-9-0-2.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer_9.0-2_amd64.deb svacer_9.0-2_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9.0-2.x86_64.rpm svacer-9.0-2.x86_64.rpm]<br />
| [[Changelog#Release 9-0-2|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9-0-1.zip svacer-9-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer_9.0-1_amd64.deb svacer_9.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9.0-1.x86_64.rpm svacer-9.0-1.x86_64.rpm]<br />
| [[Changelog#Release 9-0-1|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9-0-0.zip svacer-9-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer_9.0-0_amd64.deb svacer_9.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9.0-0.x86_64.rpm svacer-9.0-0.x86_64.rpm]<br />
| [[Changelog#Release 9-0-0|Changelog]]<br />[[Release notes 9-0-0|Release notes]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 8.0.1 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8-0-1.zip svacer-8-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer_8.0-1_amd64.deb svacer_8.0-1_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0-1.x86_64.rpm svacer-8.0-1.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0.1.msi svacer-8.0.1.msi]<br />
| [[Changelog#Release 8-0-1|Changelog]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|-<br />
| 8.0.0 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8-0-0.zip svacer-8-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer_8.0-0_amd64.deb svacer_8.0-0_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0-0.x86_64.rpm svacer-8.0-0.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0.0.msi svacer-8.0.0.msi]<br />
| [[Changelog#Release 8-0-0|Changelog]]<br />[[Release notes 8-0-0|Release notes]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|}<br />
<br />
[https://svacer.ispras.ru/releases Предыдущие релизы] | [https://nextcloud.ispras.ru/index.php/s/x4r4cMJAMr5RZtd?path=%2F Еще более старые релизы]<br />
<br />
=== FAQ ===<br />
* [https://gitlab.ispras.ru/svace/svace-support/-/wikis/home Документация на статический анализатор Svace]<br />
* [[Help:Introduction#Системные требования|Системные требования]]<br />
* [[Примеры использования хуков#Создание кейсов в системах отслеживания ошибок|Создание из Svacer кейсов в Gitlab, Jira, Redmine]]<br />
* Public REST API <br />
:* [[Help:Public API#Примеры использования public REST API|Примеры использования]]<br />
:* [https://gitlab.ispras.ru/svacer-public Репозитории с примерами на Python и Go] <br />
:* [https://svacer-demo.ispras.ru/api/public/swagger/ Спецификация OpenAPI]<br />
* [https://t.me/+6pvgZ0oveNVhOTc6 Группа технической поддержки в Telegram]<br />
<br />
=== Демо ===<br />
https://svacer-demo.ispras.ru<br />
<br />
* admin / admin — логин / пароль администратора<br />
* user / user — логин / пароль пользователя</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3512Help:13-alpha new features2026-05-21T12:32:17Z<p>Mitrofanov: </p>
<hr />
<div>== Разметка маркеров с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
<br />
Видео с примером разметки одиночного маркера и группы маркеров с помощью LLM:<br />
<br />
== Пример применения MCP-сервера ==<br />
Видео с примером взаимодействия LLM с сервером Svacer через MCP:<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления «старых» снимков, «пустых» веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты Pfixer теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Видео с примером использования:<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты Reviewer теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя и после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin(Svace) детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3511Help:13-alpha new features2026-05-21T12:28:59Z<p>Mitrofanov: </p>
<hr />
<div>== Разметка с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
Ниже приведены примеры скриншот диалогов разметки<br />
<br />
== Пример применения MCP-сервера ==<br />
Краткое видео с примером взаимодействия LLM с сервером Svacer через MCP.<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления «старых» снимков, «пустых» веток и проектов (Cleanup) .<br />
<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
<br />
* добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
* все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
* добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
* доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты Pfixer теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
<br />
Ниже приведены скриншоты формы функциональности '''Изменения путей.'''<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты Reviewer теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
<br />
Ниже представлены скриншоты функциональности '''Миграция разметки'''.<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя и после их редактирования можно вернуть настройки по умолчанию.<br />
<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
<br />
* Серьезность;<br />
* Надежность;<br />
* Ситуация;<br />
* CWE;<br />
* Описание.<br />
<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin(Svace) детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_new_features&diff=3510Help:13-alpha new features2026-05-21T12:21:21Z<p>Mitrofanov: Created page with "== Разметка с помощью LLM == После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку..."</p>
<hr />
<div>== Разметка с помощью LLM ==<br />
После установки, конфигурирования Validation Server и подключения LLM в диалогах разметки (одного маркера и группы маркеров) в параметре Модель AI должны появиться подключенные LLM, выбирая которые можно получить прогнозируемую моделью разметку и комментарий.<br />
Ниже приведены примеры скриншот диалогов разметки<br />
<br />
<br />
== Настройка правил автоудаления ==<br />
В CLI был доработан функционал по управлению правилами автоудаления «старых» снимков, «пустых» веток и проектов (Cleanup) .<br />
Также настройка правилам автоудаления теперь доступна в UI. Помимо того, что представлено в тестовом релизе, планируется еще добавить функцию предпросмотра затрагиваемого правилами контекста.<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
Ниже приведены скриншоты формы списка правил автоудаления и диалога создания правила.<br />
<br />
<br />
== Настройка правил автомиграциии разметки ==<br />
В CLI был доработан функционал по управлению правилами автомиграции разметки (Cleanup):<br />
- добавлена возможность вводить в правилах регулярные выражения как для исходного контекста, так и для целевого;<br />
- все заданные параметры в правилах могут быть как положительными, так и исключающими;<br />
- добавлена возможность предпросмотра затрагиваемых правилами существующих проектов/веток;<br />
- доработан вывод в лог автомиграции.<br />
<br />
Также настройка правил автомиграции разметки теперь доступна в UI.<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
Ниже приведены скриншоты формы списка правил автомиграции разметки, диалога создания правила и просмотра лога автомиграции.<br />
<br />
== Изменение путей в снимке ==<br />
Функциональность существующей утилиты Pfixer теперь доступна в UI. Также, помимо сохранения результатов в snap-файл в UI, добавлена возможность сохранения результатов в новый снимок.<br />
Ниже приведены скриншоты формы функциональности """Изменения путей"""<br />
<br />
== Миграция разметки ==<br />
Функциональность существующей утилиты Reviewer теперь доступна в UI. Перед применением заданных правил миграции разметки между ветками В UI есть возможность просмотра и корректировки сформированного плана миграции.<br />
Ниже представлены скриншоты функциональности """Миграция разметки"""<br />
<br />
== Редактирование описания детектора ==<br />
Добавлена возможность редактирования и удаления детекторов. Детекторы от Svace (источник builtin) удалить нельзя и после их редактирования можно вернуть настройки по умолчанию.<br />
Для редактирования доступны доступны следующие атрибуты детектора:<br />
- Серьезность;<br />
- Надежность;<br />
- Ситуация;<br />
- CWE;<br />
- Описание.<br />
Функциональность доступна только пользователям с серверным доступом "Администрирование сервера".<br />
Ниже приведены скриншоты обновленного реестра детекторов и диалог редактирования builtin(Svace) детектора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Svacer&diff=3509Svacer2026-05-21T10:06:14Z<p>Mitrofanov: </p>
<hr />
<div>Svacer — сервер для хранения и обработки результатов статического анализа. Поддерживает импорт результатов анализа из [https://svace.ispras.ru Svace] напрямую и из прочих анализаторов через формат [[Help:Sarif|SARIF]].<br />
<br />
=== Документация ===<br />
Version 12.x.x<br />
# [[Help:Introduction|Введение]]<br />
# [[Help:Installation|Установка и обновление]]<br />
# [[Help:Configuration|Настройка сервера]]<br />
# [[Help:Import from Svace|Импорт из Svace]]<br />
# [[Help:Backup|Резервное копирование]]<br />
# [[Help:UI manual|Использование веб-интерфейса]]<br />
# [[Help:Public API|Public REST API]]<br />
# [[Help:CLI|CLI]]<br />
# [[LDAP configuration|LDAP]]<br />
# [[OIDC|OpenID Connect]]<br />
# [[Help:Sarif|SARIF]]<br />
# [[Help:Statistics|Статистика]]<br />
# [[Help:Match|Механизмы сопоставления предупреждений и переноса разметки]]<br />
# [[Help:XSvacer|XSvacer — расширение функциональности Svacer]]<br />
# [[Help:Utils|Дополнительные утилиты]]<br />
# [[Metrics|Prometheus-метрики]]<br />
# [[Pipelines|Примеры пайплайнов]]<br />
# [[Notifications|Уведомления]]<br />
Version test build от 20.05.2026<br />
# [[Help:Test build introduction|Введение]]<br />
# Установка test bulld<br />
# [[Help:Test_build_MCP|MCP-сервер]]<br />
# Обзор новых фич<br />
<br />
=== Релизы ===<br />
Также доступны в виде docker-образа на [https://hub.docker.com/r/ispras/svacer docker hub] и как пакеты в [[Help:Installation#Установка и запуск из deb/rpm пакета|репозиториях]]<br />
<br />
{| class="wikitable"<br />
! version !! distrib !! linux bin !! windows bin !! deb/rpm !! doc<br />
!svace checkers version<br />
|-<br />
| 12.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-linux.tar.gz svacer-12-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-windows.zip svacer-12-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer_12.0-1_amd64.deb svacer_12.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12.0-1.x86_64.rpm svacer-12.0-1.x86_64.rpm]<br />
| [[Changelog#Release 12-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|5.0.251220<br />
|-<br />
| 12.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-linux.tar.gz svacer-12-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-windows.zip svacer-12-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer_12.0-0_amd64.deb svacer_12.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12.0-0.x86_64.rpm svacer-12.0-0.x86_64.rpm]<br />
| [[Changelog#Release 12-0-0|Changelog]]<br />[[Release notes 12-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|4.0.251120<br />
|-<br />
| 11.2.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-linux.tar.gz svacer-11-2-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-windows.zip svacer-11-2-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer_11.2-0_amd64.deb svacer_11.2-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11.2-0.x86_64.rpm svacer-11.2-0.x86_64.rpm]<br />
| [[Changelog#Release 11-2-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.1.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-linux.tar.gz svacer-11-1-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-windows.zip svacer-11-1-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer_11.1-0_amd64.deb svacer_11.1-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11.1-0.x86_64.rpm svacer-11.1-0.x86_64.rpm]<br />
| [[Changelog#Release 11-1-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-linux.tar.gz svacer-11-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-windows.zip svacer-11-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer_11.0-0_amd64.deb svacer_11.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11.0-0.x86_64.rpm svacer-11.0-0.x86_64.rpm]<br />
| [[Changelog#Release 11-0-0|Changelog]]<br />[[Release notes 11-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 10.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-linux.tar.gz svacer-10-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-windows.zip svacer-10-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer_10.0-1_amd64.deb svacer_10.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10.0-1.x86_64.rpm svacer-10.0-1.x86_64.rpm]<br />
| [[Changelog#Release 10-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 10.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-linux.tar.gz svacer-10-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-windows.zip svacer-10-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer_10.0-0_amd64.deb svacer_10.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10.0-0.x86_64.rpm svacer-10.0-0.x86_64.rpm]<br />
| [[Changelog#Release 10-0-0|Changelog]]<br />[[Release notes 10-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 9.0.2<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9-0-2.zip svacer-9-0-2.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer_9.0-2_amd64.deb svacer_9.0-2_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9.0-2.x86_64.rpm svacer-9.0-2.x86_64.rpm]<br />
| [[Changelog#Release 9-0-2|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9-0-1.zip svacer-9-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer_9.0-1_amd64.deb svacer_9.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9.0-1.x86_64.rpm svacer-9.0-1.x86_64.rpm]<br />
| [[Changelog#Release 9-0-1|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9-0-0.zip svacer-9-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer_9.0-0_amd64.deb svacer_9.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9.0-0.x86_64.rpm svacer-9.0-0.x86_64.rpm]<br />
| [[Changelog#Release 9-0-0|Changelog]]<br />[[Release notes 9-0-0|Release notes]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 8.0.1 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8-0-1.zip svacer-8-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer_8.0-1_amd64.deb svacer_8.0-1_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0-1.x86_64.rpm svacer-8.0-1.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0.1.msi svacer-8.0.1.msi]<br />
| [[Changelog#Release 8-0-1|Changelog]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|-<br />
| 8.0.0 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8-0-0.zip svacer-8-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer_8.0-0_amd64.deb svacer_8.0-0_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0-0.x86_64.rpm svacer-8.0-0.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0.0.msi svacer-8.0.0.msi]<br />
| [[Changelog#Release 8-0-0|Changelog]]<br />[[Release notes 8-0-0|Release notes]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|}<br />
<br />
[https://svacer.ispras.ru/releases Предыдущие релизы] | [https://nextcloud.ispras.ru/index.php/s/x4r4cMJAMr5RZtd?path=%2F Еще более старые релизы]<br />
<br />
=== FAQ ===<br />
* [https://gitlab.ispras.ru/svace/svace-support/-/wikis/home Документация на статический анализатор Svace]<br />
* [[Help:Introduction#Системные требования|Системные требования]]<br />
* [[Примеры использования хуков#Создание кейсов в системах отслеживания ошибок|Создание из Svacer кейсов в Gitlab, Jira, Redmine]]<br />
* Public REST API <br />
:* [[Help:Public API#Примеры использования public REST API|Примеры использования]]<br />
:* [https://gitlab.ispras.ru/svacer-public Репозитории с примерами на Python и Go] <br />
:* [https://svacer-demo.ispras.ru/api/public/swagger/ Спецификация OpenAPI]<br />
* [https://t.me/+6pvgZ0oveNVhOTc6 Группа технической поддержки в Telegram]<br />
<br />
=== Демо ===<br />
https://svacer-demo.ispras.ru<br />
<br />
* admin / admin — логин / пароль администратора<br />
* user / user — логин / пароль пользователя</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Svacer&diff=3508Svacer2026-05-21T10:05:59Z<p>Mitrofanov: </p>
<hr />
<div>Svacer — сервер для хранения и обработки результатов статического анализа. Поддерживает импорт результатов анализа из [https://svace.ispras.ru Svace] напрямую и из прочих анализаторов через формат [[Help:Sarif|SARIF]].<br />
<br />
=== Документация ===<br />
Version 12.x.x<br />
# [[Help:Introduction|Введение]]<br />
# [[Help:Installation|Установка и обновление]]<br />
# [[Help:Configuration|Настройка сервера]]<br />
# [[Help:Import from Svace|Импорт из Svace]]<br />
# [[Help:Backup|Резервное копирование]]<br />
# [[Help:UI manual|Использование веб-интерфейса]]<br />
# [[Help:Public API|Public REST API]]<br />
# [[Help:CLI|CLI]]<br />
# [[LDAP configuration|LDAP]]<br />
# [[OIDC|OpenID Connect]]<br />
# [[Help:Sarif|SARIF]]<br />
# [[Help:Statistics|Статистика]]<br />
# [[Help:Match|Механизмы сопоставления предупреждений и переноса разметки]]<br />
# [[Help:XSvacer|XSvacer — расширение функциональности Svacer]]<br />
# [[Help:Utils|Дополнительные утилиты]]<br />
# [[Metrics|Prometheus-метрики]]<br />
# [[Pipelines|Примеры пайплайнов]]<br />
# [[Notifications|Уведомления]]<br />
Version test build от 20.05.2026<br />
# [[Help:Test build introduction|Введение<br />
# Установка test bulld<br />
# [[Help:Test_build_MCP|MCP-сервер]]<br />
# Обзор новых фич<br />
<br />
=== Релизы ===<br />
Также доступны в виде docker-образа на [https://hub.docker.com/r/ispras/svacer docker hub] и как пакеты в [[Help:Installation#Установка и запуск из deb/rpm пакета|репозиториях]]<br />
<br />
{| class="wikitable"<br />
! version !! distrib !! linux bin !! windows bin !! deb/rpm !! doc<br />
!svace checkers version<br />
|-<br />
| 12.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-linux.tar.gz svacer-12-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-windows.zip svacer-12-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer_12.0-1_amd64.deb svacer_12.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12.0-1.x86_64.rpm svacer-12.0-1.x86_64.rpm]<br />
| [[Changelog#Release 12-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|5.0.251220<br />
|-<br />
| 12.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-linux.tar.gz svacer-12-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-windows.zip svacer-12-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer_12.0-0_amd64.deb svacer_12.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12.0-0.x86_64.rpm svacer-12.0-0.x86_64.rpm]<br />
| [[Changelog#Release 12-0-0|Changelog]]<br />[[Release notes 12-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|4.0.251120<br />
|-<br />
| 11.2.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-linux.tar.gz svacer-11-2-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-windows.zip svacer-11-2-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer_11.2-0_amd64.deb svacer_11.2-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11.2-0.x86_64.rpm svacer-11.2-0.x86_64.rpm]<br />
| [[Changelog#Release 11-2-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.1.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-linux.tar.gz svacer-11-1-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-windows.zip svacer-11-1-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer_11.1-0_amd64.deb svacer_11.1-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11.1-0.x86_64.rpm svacer-11.1-0.x86_64.rpm]<br />
| [[Changelog#Release 11-1-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-linux.tar.gz svacer-11-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-windows.zip svacer-11-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer_11.0-0_amd64.deb svacer_11.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11.0-0.x86_64.rpm svacer-11.0-0.x86_64.rpm]<br />
| [[Changelog#Release 11-0-0|Changelog]]<br />[[Release notes 11-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 10.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-linux.tar.gz svacer-10-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-windows.zip svacer-10-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer_10.0-1_amd64.deb svacer_10.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10.0-1.x86_64.rpm svacer-10.0-1.x86_64.rpm]<br />
| [[Changelog#Release 10-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 10.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-linux.tar.gz svacer-10-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-windows.zip svacer-10-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer_10.0-0_amd64.deb svacer_10.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10.0-0.x86_64.rpm svacer-10.0-0.x86_64.rpm]<br />
| [[Changelog#Release 10-0-0|Changelog]]<br />[[Release notes 10-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 9.0.2<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9-0-2.zip svacer-9-0-2.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer_9.0-2_amd64.deb svacer_9.0-2_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9.0-2.x86_64.rpm svacer-9.0-2.x86_64.rpm]<br />
| [[Changelog#Release 9-0-2|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9-0-1.zip svacer-9-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer_9.0-1_amd64.deb svacer_9.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9.0-1.x86_64.rpm svacer-9.0-1.x86_64.rpm]<br />
| [[Changelog#Release 9-0-1|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9-0-0.zip svacer-9-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer_9.0-0_amd64.deb svacer_9.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9.0-0.x86_64.rpm svacer-9.0-0.x86_64.rpm]<br />
| [[Changelog#Release 9-0-0|Changelog]]<br />[[Release notes 9-0-0|Release notes]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 8.0.1 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8-0-1.zip svacer-8-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer_8.0-1_amd64.deb svacer_8.0-1_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0-1.x86_64.rpm svacer-8.0-1.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0.1.msi svacer-8.0.1.msi]<br />
| [[Changelog#Release 8-0-1|Changelog]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|-<br />
| 8.0.0 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8-0-0.zip svacer-8-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer_8.0-0_amd64.deb svacer_8.0-0_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0-0.x86_64.rpm svacer-8.0-0.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0.0.msi svacer-8.0.0.msi]<br />
| [[Changelog#Release 8-0-0|Changelog]]<br />[[Release notes 8-0-0|Release notes]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|}<br />
<br />
[https://svacer.ispras.ru/releases Предыдущие релизы] | [https://nextcloud.ispras.ru/index.php/s/x4r4cMJAMr5RZtd?path=%2F Еще более старые релизы]<br />
<br />
=== FAQ ===<br />
* [https://gitlab.ispras.ru/svace/svace-support/-/wikis/home Документация на статический анализатор Svace]<br />
* [[Help:Introduction#Системные требования|Системные требования]]<br />
* [[Примеры использования хуков#Создание кейсов в системах отслеживания ошибок|Создание из Svacer кейсов в Gitlab, Jira, Redmine]]<br />
* Public REST API <br />
:* [[Help:Public API#Примеры использования public REST API|Примеры использования]]<br />
:* [https://gitlab.ispras.ru/svacer-public Репозитории с примерами на Python и Go] <br />
:* [https://svacer-demo.ispras.ru/api/public/swagger/ Спецификация OpenAPI]<br />
* [https://t.me/+6pvgZ0oveNVhOTc6 Группа технической поддержки в Telegram]<br />
<br />
=== Демо ===<br />
https://svacer-demo.ispras.ru<br />
<br />
* admin / admin — логин / пароль администратора<br />
* user / user — логин / пароль пользователя</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Svacer&diff=3507Svacer2026-05-21T10:05:22Z<p>Mitrofanov: </p>
<hr />
<div>Svacer — сервер для хранения и обработки результатов статического анализа. Поддерживает импорт результатов анализа из [https://svace.ispras.ru Svace] напрямую и из прочих анализаторов через формат [[Help:Sarif|SARIF]].<br />
<br />
=== Документация ===<br />
Version 12.x.x<br />
# [[Help:Introduction|Введение]]<br />
# [[Help:Installation|Установка и обновление]]<br />
# [[Help:Configuration|Настройка сервера]]<br />
# [[Help:Import from Svace|Импорт из Svace]]<br />
# [[Help:Backup|Резервное копирование]]<br />
# [[Help:UI manual|Использование веб-интерфейса]]<br />
# [[Help:Public API|Public REST API]]<br />
# [[Help:CLI|CLI]]<br />
# [[LDAP configuration|LDAP]]<br />
# [[OIDC|OpenID Connect]]<br />
# [[Help:Sarif|SARIF]]<br />
# [[Help:Statistics|Статистика]]<br />
# [[Help:Match|Механизмы сопоставления предупреждений и переноса разметки]]<br />
# [[Help:XSvacer|XSvacer — расширение функциональности Svacer]]<br />
# [[Help:Utils|Дополнительные утилиты]]<br />
# [[Metrics|Prometheus-метрики]]<br />
# [[Pipelines|Примеры пайплайнов]]<br />
# [[Notifications|Уведомления]]<br />
Version test build от 20.05.2026<br />
# [[Help:Test build introduction|Введение]]<br />
# [[Help:Test_build_MCP|Установка test bulld]]<br />
# MCP-сервер<br />
# Обзор новых фич<br />
<br />
=== Релизы ===<br />
Также доступны в виде docker-образа на [https://hub.docker.com/r/ispras/svacer docker hub] и как пакеты в [[Help:Installation#Установка и запуск из deb/rpm пакета|репозиториях]]<br />
<br />
{| class="wikitable"<br />
! version !! distrib !! linux bin !! windows bin !! deb/rpm !! doc<br />
!svace checkers version<br />
|-<br />
| 12.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-linux.tar.gz svacer-12-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12-0-1-windows.zip svacer-12-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-1/svacer_12.0-1_amd64.deb svacer_12.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-1/svacer-12.0-1.x86_64.rpm svacer-12.0-1.x86_64.rpm]<br />
| [[Changelog#Release 12-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|5.0.251220<br />
|-<br />
| 12.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-linux.tar.gz svacer-12-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12-0-0-windows.zip svacer-12-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server svacer-server]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.sig svacer-server.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server.exe svacer-server.exe]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-server_win.sig svacer-server_win.sig]<br />
| [https://svacer.ispras.ru/releases/svacer-12-0-0/svacer_12.0-0_amd64.deb svacer_12.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-12-0-0/svacer-12.0-0.x86_64.rpm svacer-12.0-0.x86_64.rpm]<br />
| [[Changelog#Release 12-0-0|Changelog]]<br />[[Release notes 12-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Svacer#Документация|Documentation 12.x.x]]<br />
|4.0.251120<br />
|-<br />
| 11.2.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-linux.tar.gz svacer-11-2-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11-2-0-windows.zip svacer-11-2-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-2-0/svacer_11.2-0_amd64.deb svacer_11.2-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-2-0/svacer-11.2-0.x86_64.rpm svacer-11.2-0.x86_64.rpm]<br />
| [[Changelog#Release 11-2-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.1.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-linux.tar.gz svacer-11-1-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11-1-0-windows.zip svacer-11-1-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-1-0/svacer_11.1-0_amd64.deb svacer_11.1-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-1-0/svacer-11.1-0.x86_64.rpm svacer-11.1-0.x86_64.rpm]<br />
| [[Changelog#Release 11-1-0|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 11.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-linux.tar.gz svacer-11-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11-0-0-windows.zip svacer-11-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-11-0-0/svacer_11.0-0_amd64.deb svacer_11.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-11-0-0/svacer-11.0-0.x86_64.rpm svacer-11.0-0.x86_64.rpm]<br />
| [[Changelog#Release 11-0-0|Changelog]]<br />[[Release notes 11-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 11.x.x]]<br />
|4.0.250415<br />
|-<br />
| 10.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-linux.tar.gz svacer-10-0-1-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10-0-1-windows.zip svacer-10-0-1-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-1/svacer_10.0-1_amd64.deb svacer_10.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-1/svacer-10.0-1.x86_64.rpm svacer-10.0-1.x86_64.rpm]<br />
| [[Changelog#Release 10-0-1|Changelog]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 10.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-linux.tar.gz svacer-10-0-0-linux.tar.gz]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10-0-0-windows.zip svacer-10-0-0-windows.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-10-0-0/svacer_10.0-0_amd64.deb svacer_10.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-10-0-0/svacer-10.0-0.x86_64.rpm svacer-10.0-0.x86_64.rpm]<br />
| [[Changelog#Release 10-0-0|Changelog]]<br />[[Release notes 10-0-0|Release notes]]<br />[[Help:Installation#Обновление|Upgrade notes]]<br />[[Documentation 10.x.x]]<br />
|4.0.241102<br />
|-<br />
| 9.0.2<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9-0-2.zip svacer-9-0-2.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-2/svacer_9.0-2_amd64.deb svacer_9.0-2_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-2/svacer-9.0-2.x86_64.rpm svacer-9.0-2.x86_64.rpm]<br />
| [[Changelog#Release 9-0-2|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.1<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9-0-1.zip svacer-9-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-1/svacer_9.0-1_amd64.deb svacer_9.0-1_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-1/svacer-9.0-1.x86_64.rpm svacer-9.0-1.x86_64.rpm]<br />
| [[Changelog#Release 9-0-1|Changelog]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 9.0.0<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9-0-0.zip svacer-9-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer svacer]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server svacer-server]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer.exe svacer.exe]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-server.exe svacer-server.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-9-0-0/svacer_9.0-0_amd64.deb svacer_9.0-0_amd64.deb]<br />[https://svacer.ispras.ru/releases/svacer-9-0-0/svacer-9.0-0.x86_64.rpm svacer-9.0-0.x86_64.rpm]<br />
| [[Changelog#Release 9-0-0|Changelog]]<br />[[Release notes 9-0-0|Release notes]]<br />[[Help:Installation#9-0-0|Upgrade notes]]<br />[[Documentation 9.x.x]]<br />
|3.4.240312<br />
|-<br />
| 8.0.1 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8-0-1.zip svacer-8-0-1.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer_8.0-1_amd64.deb svacer_8.0-1_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0-1.x86_64.rpm svacer-8.0-1.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-1/svacer-8.0.1.msi svacer-8.0.1.msi]<br />
| [[Changelog#Release 8-0-1|Changelog]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|-<br />
| 8.0.0 <br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8-0-0.zip svacer-8-0-0.zip]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer svacer]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer.exe svacer.exe]<br />
| [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer_8.0-0_amd64.deb svacer_8.0-0_amd64.deb]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0-0.x86_64.rpm svacer-8.0-0.x86_64.rpm]<br /> [https://svacer.ispras.ru/releases/svacer-8-0-0/svacer-8.0.0.msi svacer-8.0.0.msi]<br />
| [[Changelog#Release 8-0-0|Changelog]]<br />[[Release notes 8-0-0|Release notes]]<br />[[Documentation 8.x.x]]<br />
|3.4.0<br />
|}<br />
<br />
[https://svacer.ispras.ru/releases Предыдущие релизы] | [https://nextcloud.ispras.ru/index.php/s/x4r4cMJAMr5RZtd?path=%2F Еще более старые релизы]<br />
<br />
=== FAQ ===<br />
* [https://gitlab.ispras.ru/svace/svace-support/-/wikis/home Документация на статический анализатор Svace]<br />
* [[Help:Introduction#Системные требования|Системные требования]]<br />
* [[Примеры использования хуков#Создание кейсов в системах отслеживания ошибок|Создание из Svacer кейсов в Gitlab, Jira, Redmine]]<br />
* Public REST API <br />
:* [[Help:Public API#Примеры использования public REST API|Примеры использования]]<br />
:* [https://gitlab.ispras.ru/svacer-public Репозитории с примерами на Python и Go] <br />
:* [https://svacer-demo.ispras.ru/api/public/swagger/ Спецификация OpenAPI]<br />
* [https://t.me/+6pvgZ0oveNVhOTc6 Группа технической поддержки в Telegram]<br />
<br />
=== Демо ===<br />
https://svacer-demo.ispras.ru<br />
<br />
* admin / admin — логин / пароль администратора<br />
* user / user — логин / пароль пользователя</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_MCP&diff=3506Help:13-alpha MCP2026-05-21T10:03:25Z<p>Mitrofanov: /* Разобрать конкретное предупреждение */</p>
<hr />
<div>== Архитектура ==<br />
[https://modelcontextprotocol.io/docs/getting-started/intro MCP] — открытый стандарт, через который LLM-клиенты (Claude Desktop, Cursor, VS Code, OpenWebUI и др.) вызывают внешние инструменты. <br />
Svacer MCP соединяет одно с другим: 8 инструментов поверх публичного REST API Svacer, которые LLM выбирает и вызывает в ответ на обычный текстовый запрос. Вместо ручной последовательности «открыть UI, найти проект, выбрать снимок, применить фильтр» достаточно сформулировать вопрос в чате, например, «сколько критических предупреждений в последнем снимке bash?», и получить ответ. Необходимые вызовы инструментов модель выполняет самостоятельно.<br />
<br />
[[File:Архитектура MCP.png|thumb|none|x800px|alt=architectureMCP|Архитектура MCP-сервер]]<br />
<br />
Поток запроса: LLM-клиент отправляет MCP-вызов через STDIO или Streamable HTTP → <code>server.py</code> передаёт его в выбранный инструмент из <code>tools/</code> → инструмент проверяет параметры и обращается к <code>api_client.py</code> → клиент получает JWT от <code>auth.py</code> (модуль автоматически обновляет токен по истечении срока действия или при ответе 401) → запрос отправляется в Svacer REST API.<br />
<br />
== Установка ==<br />
Установка Svacer MCP, подключение клиентов и конфигурация.<br />
<br />
=== Требования ===<br />
<br />
* Python 3.10+<br />
* Доступ к Svacer-серверу: URL + логин/пароль<br />
<br />
=== Режим STDIO ===<br />
Подходит для настольных клиентов: Claude Desktop, Claude Code, Cursor, VS Code.<br />
<code>git clone <nowiki>https://gitlab.ispras.ru/svacerai/mcp.git</nowiki> && cd mcp<br />
<br />
python3 -m venv .venv<br />
.venv/bin/pip install -e .<br />
<br />
cp .env.example .env<br />
# Отредактировать .env — указать URL и учётные данные Svacer<br />
<br />
# Проверить запуск (сервер ожидает данные на stdin; для выхода — Ctrl+C)<br />
.venv/bin/svacer-mcp</code><br />
После <code>pip install -e .</code> в окружении становится доступна команда <code>svacer-mcp</code> — её указывают в конфигурации клиентов ниже.<br />
<br />
=== Режим HTTP (Docker) ===<br />
Подходит для веб-клиентов (OpenWebUI) и удалённого доступа.<br />
<br />
'''Требования:''' Docker, Docker Compose.<br />
<code>cp .env.example .env<br />
<br />
# В .env обязательно задать SVACER_MCP_TOKEN — без него сервер не запускается<br />
echo "SVACER_MCP_TOKEN=$(openssl rand -hex 32)" >> .env<br />
<br />
docker compose up -d<br />
<br />
# MCP endpoint: <nowiki>http://localhost:8002/mcp</nowiki><br />
# Клиенты передают заголовок: Authorization: Bearer <SVACER_MCP_TOKEN></code><br />
Внешний порт хоста задаётся переменной <code>MCP_PORT</code> (по умолчанию <code>8002</code>), внутри контейнера сервер всегда слушает порт <code>8000</code>.<br />
<br />
=== Подключение клиентов ===<br />
<br />
==== Claude Desktop ====<br />
Файл конфигурации: <code>~/.config/Claude/claude_desktop_config.json</code> (Linux) или <code>%APPDATA%\Claude\claude_desktop_config.json</code> (Windows).<br />
<br />
Укажите '''абсолютный путь''' к <code>svacer-mcp</code> из вашего venv (<code>which svacer-mcp</code> в активированном venv или <code>/path/to/mcp/.venv/bin/svacer-mcp</code>).<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Claude Code ====<br />
<code>claude mcp add svacer \<br />
-e SVACER_URL=<nowiki>https://your-svacer.example.com</nowiki> \<br />
-e SVACER_LOGIN=your-login \<br />
-e SVACER_PASSWORD=your-password \<br />
-- /path/to/mcp/.venv/bin/svacer-mcp</code><br />
<br />
==== VS Code ====<br />
Файл <code>.vscode/mcp.json</code> в корне рабочей директории:<br />
<code>{<br />
"servers": {<br />
"svacer": {<br />
"type": "stdio",<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Cursor ====<br />
Файл <code>.cursor/mcp.json</code> в корне проекта или глобально:<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== OpenWebUI ====<br />
<br />
# Развернуть через Docker (см. «Режим HTTP» выше).<br />
# Открыть '''Settings → Tools''' (или '''Admin Panel → Settings → Tools''').<br />
# Добавить сервер:<br />
#* <code><nowiki>http://localhost:8002/mcp</nowiki></code> — если OpenWebUI работает на хосте, снаружи Docker.<br />
#* <code><nowiki>http://svacer-mcp:8000/mcp</nowiki></code> — если OpenWebUI развёрнут в той же compose-сети, что и <code>svacer-mcp</code> (имя берётся из <code>docker-compose.yml</code> → service name, порт 8000 — внутренний порт контейнера).<br />
# Тип подключения: '''MCP (Streamable HTTP)'''.<br />
# В настройках инструмента указать заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code> (значение — то же, что в <code>.env</code> сервера).<br />
# Сохранить — инструменты появятся в чате.<br />
<br />
=== Конфигурация ===<br />
{| class="wikitable"<br />
!Переменная<br />
!По умолчанию<br />
!Описание<br />
|-<br />
|<code>SVACER_URL</code><br />
|<code><nowiki>https://svacer-demo.ispras.ru</nowiki></code><br />
|URL Svacer-сервера<br />
|-<br />
|<code>SVACER_LOGIN</code><br />
|<code>admin</code><br />
|Логин<br />
|-<br />
|<code>SVACER_PASSWORD</code><br />
|<code>admin</code><br />
|Пароль<br />
|-<br />
|<code>SVACER_TIMEOUT</code><br />
|<code>30</code><br />
|Тайм-аут HTTP-запросов к Svacer, секунды<br />
|-<br />
|<code>SVACER_TRANSPORT</code><br />
|<code>stdio</code><br />
|Режим транспорта: <code>stdio</code> или <code>http</code><br />
|-<br />
|<code>SVACER_HTTP_PORT</code><br />
|<code>8000</code><br />
|TCP-порт сервера в режиме HTTP (внутри контейнера)<br />
|-<br />
|<code>SVACER_MCP_TOKEN</code><br />
|''(не задано)''<br />
|Bearer-токен для клиентов <code>/mcp</code>. Обязателен при <code>SVACER_TRANSPORT=http</code>, в режиме STDIO игнорируется. Генерация: <code>openssl rand -hex 32</code><br />
|-<br />
|<code>SVACER_MCP_RESOURCE_URL</code><br />
|<code><nowiki>http://localhost</nowiki>:<HTTP_PORT></code><br />
|Публичный URL MCP-сервера для заголовка <code>WWW-Authenticate</code> (<nowiki>RFC 9728</nowiki>). Задаётся при работе за обратным прокси<br />
|-<br />
|<code>SVACER_TOOLS</code><br />
|''(не задано)''<br />
|Список инструментов через запятую. Если не задано, регистрируются все 8<br />
|-<br />
|<code>MCP_PORT</code><br />
|<code>8002</code><br />
|Внешний порт хоста при запуске через <code>docker compose</code> (отображается на внутренний <code>SVACER_HTTP_PORT</code>)<br />
|}<br />
Переменные читаются из <code>.env</code> или из окружения. Для STDIO-клиентов их можно указать в секции <code>env</code> конфигурации клиента.<br />
<br />
==== Ограничение набора инструментов ====<br />
Чтобы запустить сервер с подмножеством инструментов (например, для уменьшения объёма контекста у модели или разграничения доступа), задайте <code>SVACER_TOOLS</code>:<br />
<code>SVACER_TOOLS=get_projects,get_snapshots,get_markers</code><br />
Допустимые имена: <code>get_projects</code>, <code>get_snapshots</code>, <code>get_warnings</code>, <code>get_markers</code>, <code>get_project_stats</code>, <code>get_project_groups</code>, <code>get_advanced_file_preview</code>, <code>get_diff</code>. Неизвестное имя в списке приводит к ошибке при запуске. Если переменная пустая или не задана, регистрируются все 8 инструментов.<br />
<br />
==== Несколько экземпляров сервера ====<br />
Параллельный запуск нескольких MCP-серверов поддерживается без ограничений.<br />
<br />
* В режиме STDIO каждая запись в конфигурации клиента описывает отдельный процесс — несколько подключений к разным экземплярам Svacer задаются простым перечислением.<br />
* В режиме HTTP запускаются независимые контейнеры на разных хост-портах: например, <code>MCP_PORT=8002</code> для одного экземпляра и <code>MCP_PORT=8003</code> для другого. Для каждого контейнера задаётся собственный <code>SVACER_MCP_TOKEN</code>.<br />
<br />
=== Безопасность ===<br />
<br />
* '''STDIO''': сервер не открывает сетевых портов и обменивается данными через стандартные потоки ввода/вывода процесса.<br />
* '''Streamable HTTP''': эндпоинт <code>/mcp</code> требует заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code>. Запросы без токена или с неверным значением получают ответ <code>401</code> и заголовок <code>WWW-Authenticate: Bearer ...</code>. Токен является разделяемым секретом и не заменяет TLS, а дополняет его: при работе за обратным прокси необходимо использовать HTTPS, а сам токен передавать только по защищённому каналу.<br />
* Без <code>SVACER_MCP_TOKEN</code> HTTP-сервер не запускается.<br />
* Учётные данные <code>admin/admin</code> предназначены только для тестового стенда. В рабочем окружении необходимо задать собственные логин и пароль через переменные окружения.<br />
* Файл <code>.env</code> не должен добавляться в систему контроля версий.<br />
<br />
==== Передача токена клиентом ====<br />
Большинство HTTP-клиентов MCP (OpenWebUI и др.) позволяют задать произвольный заголовок <code>Authorization</code> в настройках инструмента — указывается значение <code>Bearer <токен></code>. Для ручной проверки:<br />
<code>curl -H "Authorization: Bearer $SVACER_MCP_TOKEN" \<br />
<nowiki> </nowiki> -H 'Content-Type: application/json' \<br />
<nowiki> </nowiki> -H 'Accept: application/json, text/event-stream' \<br />
<nowiki> </nowiki> -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}' \<br />
<nowiki> </nowiki> <nowiki>http://localhost:8002/mcp</nowiki></code><br />
<br />
== Инструменты ==<br />
Справочник по 8 инструментам Svacer MCP. Типичный порядок вызовов: <code>get_projects</code> → <code>get_snapshots</code> → любой из аналитических инструментов.<br />
{| class="wikitable"<br />
!Инструмент<br />
!Назначение<br />
|-<br />
|<code>get_projects</code><br />
|Список проектов с ветками — точка входа<br />
|-<br />
|<code>get_snapshots</code><br />
|Снимки конкретной ветки, от нового к старому<br />
|-<br />
|<code>get_project_stats</code><br />
|Агрегированные метрики снимка: severity / review / checker<br />
|-<br />
|<code>get_markers</code><br />
|Компактный список маркеров с серверной фильтрацией<br />
|-<br />
|<code>get_warnings</code><br />
|Полные предупреждения с трассами и историей ревью<br />
|-<br />
|<code>get_diff</code><br />
|Сравнение двух снимков: new / missing / modified / matched<br />
|-<br />
|<code>get_advanced_file_preview</code><br />
|Фрагмент исходного кода вокруг строки<br />
|-<br />
|<code>get_project_groups</code><br />
|Группа проектов по имени или UUID<br />
|}<br />
<br />
=== get_projects ===<br />
Список всех проектов с ветками. Точка входа: с этого вызова начинается практически любой сценарий — он возвращает <code>project_id</code> и <code>branch_id</code>, необходимые для последующих запросов.<br />
<br />
'''Параметров нет.'''<br />
<br />
'''Вызов:'''<br />
<code>get_projects()</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"project_id": "91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
"project_name": "bash",<br />
"created": "2021-12-13T13:22:42.122456Z",<br />
"created_by": "admin",<br />
"branches": [<br />
{<br />
"branch_id": "77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
"branch_name": "master",<br />
"created": "2021-12-13T13:22:42.394812Z"<br />
}<br />
]<br />
}<br />
]</code><br />
----<br />
<br />
=== get_snapshots ===<br />
Список снимков для конкретной ветки проекта, от нового к старому.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>name_filter</code><br />
|string<br />
|нет<br />
|Подстрока или regex для фильтра по имени снимка<br />
|}<br />
'''Вызов:'''<br />
<code>get_snapshots(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4"<br />
)</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"snapshot_id": "b42cb563-86f4-4f96-900a-7782163327c9",<br />
"name": "Snapshot 2020-03-25 09:09:41 +0300",<br />
"import_time": "2020-03-25T09:09:41.837296Z",<br />
"commit_hash": null,<br />
"markers_count": 297,<br />
"link": "<nowiki>https://svacer-demo.ispras.ru/</nowiki>..."<br />
}<br />
]</code><br />
----<br />
<br />
=== get_project_stats ===<br />
Агрегированные метрики по снимку: общее количество предупреждений, распределение по критичности, по статусу ревью, по детекторам. Наиболее быстрый способ получить общую картину по проекту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_stats(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9"<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_warnings": 771,<br />
"by_severity": {<br />
"Critical": 1,<br />
"Major": 1,<br />
"Unspecified": 769<br />
},<br />
"by_review_status": {<br />
"Confirmed": 1,<br />
"False Positive": 1,<br />
"Undecided": 767,<br />
"Unclear": 1,<br />
"Won't fix": 1<br />
},<br />
"by_checker": {<br />
"PROC_USE.VULNERABLE": 337,<br />
"UNUSED_FUNC_RES.REWRITE.MINOR": 44,<br />
"UNREACHABLE_CODE": 28,<br />
"DEREF_AFTER_NULL.EX": 27,<br />
"NULL_AFTER_DEREF": 27<br />
}<br />
}</code><br />
----<br />
<br />
=== get_markers ===<br />
Компактный список маркеров с серверной фильтрацией. Основной инструмент для перечисления и обзора: его следует предпочитать <code>get_warnings</code>, когда не требуются развёрнутые поля — трассы и история ревью.<br />
<br />
По умолчанию ответ ограничен 30 маркерами и содержит компактный набор полей. Подробнее об ограничении объёма см. раздел Про объём ответа в сценариях.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора (<code>DEREF_AFTER_NULL</code>, …)<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы маркеров<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю изменений ревью<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии к маркеру<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра из веб-интерфейса Svacer<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров в ответе (по умолчанию <code>30</code>). Значение <code>0</code> снимает ограничение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|Список разрешённых полей маркера верхнего уровня. По умолчанию — компактный набор <code>id, warnClass, file, line, msg, function, review</code>. Значение <code>["*"]</code> возвращает все поля коннектора (<code>id, warnClass, file, line, msg, tool, function, mtid, review</code>, а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены). Допустим и произвольный список — например, <code>["id","warnClass"]</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_markers(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
warnClass=["PROC_USE.VULNERABLE"]<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 341,<br />
"returned_count": 30,<br />
"truncated": true,<br />
"filters_applied": {"warnClass": ["PROC_USE.VULNERABLE"]},<br />
"markers": [<br />
{<br />
"id": "e05bb35b-a95e-4eb2-85ae-3101b788f07d",<br />
"warnClass": "PROC_USE.VULNERABLE.TEMP",<br />
"file": "/.build/lib/sh/tmpfile.c",<br />
"line": 160,<br />
"msg": "Use of vulnerable function 'mktemp' at tmpfile.c:160. ...",<br />
"function": "sh_mktmpname",<br />
"review": null<br />
}<br />
]<br />
}</code><br />
<code>total_count</code> отражает количество маркеров, удовлетворяющих фильтру до применения ограничения; <code>returned_count</code> — количество маркеров, фактически содержащихся в <code>markers</code>. При <code>truncated: true</code> следует либо сузить фильтры (<code>severity</code>, <code>warnClass</code>, <code>file</code>), либо передать <code>limit=0</code> для получения полного списка. Поля <code>tool</code> и <code>mtid</code> возвращаются только при <code>fields=["*"]</code>.<br />
----<br />
<br />
=== get_warnings ===<br />
Полные предупреждения с детальной разметкой. Ответ значительно объёмнее, чем у <code>get_markers</code>, поэтому инструмент следует использовать только тогда, когда нужны поля, отсутствующие в компактной форме: <code>traces</code>, <code>review_history</code>, <code>checker_info</code>, <code>comment_history</code>.<br />
<br />
Лимит по умолчанию — 30; при включённых <code>traces</code>, <code>review_history</code> или <code>comment_history</code> он автоматически снижается до 8, поскольку такие предупреждения существенно объёмнее.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы. Активирует режим расширенных полей (лимит по умолчанию — 8)<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю ревью. Режим расширенных полей<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии. Режим расширенных полей<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество предупреждений в ответе. По умолчанию — <code>30</code>, в режиме расширенных полей — <code>8</code>. Значение <code>0</code> снимает ограничение. Явно заданное <code>limit</code> отменяет автоматическое снижение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_warnings(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
severity=["Critical"],<br />
review_history=True,<br />
traces=True<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 1,<br />
"returned_count": 1,<br />
"truncated": false,<br />
"filters_applied": {"severity": ["Critical"], "traces": true, "review_history": true},<br />
"warnings": [<br />
{<br />
"id": "a3f21c90-1d4e-4b82-9f63-7c8e5d2a1b09",<br />
"warnClass": "DEREF_AFTER_NULL.LOOP",<br />
"file": "/.build/execute_cmd.c",<br />
"line": 3327,<br />
"msg": "Possible null pointer dereference of 'l' after loop exit.",<br />
"function": "select_query",<br />
"review": {"status": "Confirmed", "severity": "Critical"},<br />
"review_history": [{"status": "Confirmed", "changed_by": "admin", "changed_at": "2021-12-13T14:00:00Z"}],<br />
"traces": [{"file": "/.build/execute_cmd.c", "line": 3320, "msg": "Loop starts here; 'l' may exhaust the list."}]<br />
}<br />
]<br />
}</code><br />
----<br />
<br />
=== get_diff ===<br />
Сравнение двух снимков. Категории располагаются под ключом <code>markers</code>: <code>new_markers</code> (появилось в новом снимке), <code>missing_markers</code> (исчезло из нового), <code>modified_markers</code> (тот же идентификатор, изменился контекст), <code>matched_markers</code> (совпало в обоих). Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно UUID снимков.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>base_snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|Старый снимок<br />
|-<br />
|<code>head_snapshot_id</code><br />
|string (UUID)<br />
|нет<br />
|Новый снимок; если не указан, сравнение выполняется с предыдущим по времени<br />
|-<br />
|<code>level</code><br />
|int<br />
|нет<br />
|<code>0</code> — только статистика; <code>1</code> — статистика и идентификаторы маркеров; <code>2</code> — полные маркеры по категориям<br />
|-<br />
|<code>checker_info</code><br />
|bool<br />
|нет<br />
|Метаданные детекторов для маркеров (только при <code>level >= 2</code>)<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров '''на каждую категорию''' при <code>level >= 2</code>. По умолчанию — <code>20</code>, значение <code>0</code> снимает ограничение. Параметр игнорируется при <code>level < 2</code><br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code>/<code>get_warnings</code>. Применяется к маркерам внутри категорий при <code>level >= 2</code><br />
|}<br />
'''Вызов (<code>level=0</code>):'''<br />
<code>get_diff(<br />
base_snapshot_id="72b3df7b-c15a-4e3d-8f92-a041dc6e5b87",<br />
head_snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
level=0<br />
)</code><br />
'''Ответ (<code>level=0</code>):'''<br />
<code>{<br />
"stats": {<br />
"context1": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-20 ..."},<br />
"context2": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-25 ..."},<br />
"scope": ["NEW", "MISSING", "MATCHED", "MODIFIED"],<br />
"new": 9,<br />
"missing": 12,<br />
"modified": 98,<br />
"matched": 187<br />
}<br />
}</code><br />
'''Ответ (<code>level=2</code>)''' — каждая категория внутри <code>markers</code> оформляется и ограничивается независимо:<br />
<code>{<br />
"stats": {"new": 50, "missing": 5, "modified": 0, "matched": 187},<br />
"markers": {<br />
"new_markers": {<br />
"total_count": 50,<br />
"returned_count": 20,<br />
"truncated": true,<br />
"markers": [<br />
{"id": "a3f21c90-...", "warnClass": "DEREF_AFTER_NULL.LOOP", "file": "...", "line": 3327, "msg": "...", "function": "select_query", "review": null}<br />
]<br />
},<br />
"missing_markers": {"total_count": 5, "returned_count": 5, "truncated": false, "markers": [...]},<br />
"modified_markers": {"total_count": 0, "returned_count": 0, "truncated": false, "markers": []},<br />
"matched_markers": {"total_count": 187, "returned_count": 20, "truncated": true, "markers": [...]}<br />
}<br />
}</code><br />
Если требуется полное содержимое категории, следует увеличить <code>limit</code> либо запросить нужные идентификаторы отдельным вызовом <code>get_markers</code>. Маркеры внутри категорий проходят ту же компактную обработку, что и в <code>get_warnings</code>: значение <code>fields=["*"]</code> возвращает фиксированный набор полей коннектора, а не произвольные «сырые» поля API.<br />
----<br />
<br />
=== get_advanced_file_preview ===<br />
Фрагмент исходного кода из снимка вокруг указанной строки. Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно идентификатора снимка и пути к файлу.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>file_path</code><br />
|string<br />
|да<br />
|Путь к файлу в том виде, в котором его возвращают <code>get_markers</code> и <code>get_warnings</code><br />
|-<br />
|<code>line</code><br />
|int<br />
|нет<br />
|Центральная строка, нумерация с 1 (по умолчанию <code>1</code>)<br />
|-<br />
|<code>before</code><br />
|int<br />
|нет<br />
|Количество строк до центральной (по умолчанию <code>0</code>)<br />
|-<br />
|<code>after</code><br />
|int<br />
|нет<br />
|Количество строк после центральной (по умолчанию <code>99999</code> — до конца файла)<br />
|}<br />
'''Вызов:'''<br />
<code>get_advanced_file_preview(<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
file_path="/.build/execute_cmd.c",<br />
line=3327,<br />
before=10,<br />
after=10<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"line": 3327,<br />
"content": " for (l = list; l && --reply; l = l->next)\n\t;\n return (l->word->word);\n",<br />
"total_lines": 6082<br />
}</code><br />
----<br />
<br />
=== get_project_groups ===<br />
Получить группу проектов по имени или UUID. Группы объединяют проекты в логические блоки — например, по команде или продукту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>name_or_id</code><br />
|string<br />
|да<br />
|Имя группы или её UUID<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_groups(name_or_id="Linux Tools")</code><br />
'''Ответ:'''<br />
<code>{<br />
"project_group_id": "c4f8a2d1-3b7e-4f90-82ac-1d5e8f2b6c04",<br />
"project_group_name": "Linux Tools",<br />
"projects": [<br />
{"id": "91630e84-db2f-4d8c-8716-68b7fdf17a66", "name": "bash"},<br />
{"id": "d3a17f52-...", "name": "coreutils"}<br />
]<br />
}</code><br />
<code>projects[].id</code> — это <code>project_id</code>, который далее передаётся в <code>get_snapshots</code>. Группы и проекты — разные сущности; идентификатор группы и идентификатор проекта не взаимозаменяемы.<br />
<br />
== Примеры сценариев ==<br />
Приведённые ниже запросы выполнены на демонстрационном стенде <code>svacer-demo.ispras.ru</code> с использованием OpenWebUI и модели <code>qwen3-coder:30b</code>. В любом другом MCP-клиенте с моделью достаточной мощности порядок вызовов будет аналогичным.<br />
<br />
=== Про объём ответа ===<br />
<code>get_markers</code>, <code>get_warnings</code> и <code>get_diff(level=2)</code> по умолчанию ограничивают объём ответа, чтобы не перегружать контекст модели:<br />
<br />
* <code>get_markers</code> и <code>get_warnings</code> — 30 маркеров по умолчанию. Если у <code>get_warnings</code> включены <code>traces</code>, <code>review_history</code> или <code>comment_history</code>, лимит снижается до 8, поскольку такие маркеры значительно объёмнее.<br />
* <code>get_diff(level=2)</code> — 20 маркеров на каждую категорию внутри <code>markers</code> (<code>new_markers</code>/<code>missing_markers</code>/<code>modified_markers</code>/<code>matched_markers</code>).<br />
<br />
В ответе присутствуют поля <code>total_count</code>, <code>returned_count</code>, <code>truncated</code>. При <code>truncated: true</code> есть два варианта действий: сузить фильтр (<code>severity</code>, <code>warnClass</code>, <code>file</code>) либо явно увеличить <code>limit</code> (значение <code>limit=0</code> полностью снимает ограничение).<br />
<br />
Поле <code>fields</code> определяет, какие ключи маркера возвращаются. По умолчанию применяется компактный набор <code>id, warnClass, file, line, msg, function, review</code> (а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены логическими флагами и пришли с сервера). Для полного маркера со всеми служебными ключами — <code>fields=["*"]</code>. Для произвольной выборки — список полей верхнего уровня, например <code>fields=["id","warnClass"]</code>. Поле <code>review</code> — объект <code>{status, severity, action}</code>; вложенные ключи в <code>fields</code> не поддерживаются, поэтому объект <code>review</code> запрашивается целиком.<br />
<br />
=== Перечислить все проекты ===<br />
<blockquote>Какие проекты есть в Svacer?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
<br />
'''Ответ модели:'''<blockquote>В Svacer доступно 6 проектов: bash, openssl, paho.mqtt.c, coturn, zstd, darpa. У каждого — одна ветка <code>master</code>.</blockquote><br />
<br />
=== Посмотреть снимки проекта ===<br />
<blockquote>Какие снимки есть у paho.mqtt.c? Самый свежий когда?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code> — найти <code>project_id</code> и <code>branch_id</code><br />
# <code>get_snapshots(project_id=..., branch_id=...)</code><br />
<br />
'''Ответ модели:'''<blockquote>У paho.mqtt.c 3 снимка. Самый свежий — «Snapshot 2020-03-25 09:09:41 +0300» (297 маркеров). Предыдущий — 20 марта (306 маркеров).</blockquote>Поле <code>commit_hash</code> может принимать значение <code>null</code>, если проект не сохраняет хэш коммита в <code>custom_properties</code>. Имена снимков произвольны: одни проекты записывают в имя дату, другие — коммит, третьи — свободный текст.<br />
<br />
=== Сводка по проекту ===<br />
<blockquote>Что в bash в последнем снимке? Сколько всего предупреждений, есть ли критические, какие топ-детекторы?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots(project_id, branch_id)</code> — взять последний снимок<br />
# <code>get_project_stats(project_id, branch_id, snapshot_id)</code><br />
<br />
'''Ответ модели:'''<blockquote>В последнем снимке bash содержится 771 предупреждение:<br />
<br />
* Критических: 1 (Confirmed)<br />
* Major: 1 (Won't fix)<br />
* Остальные: 769 (Unspecified — не ревьюились)<br />
<br />
Топ-детекторы по количеству:<br />
<br />
# <code>PROC_USE.VULNERABLE</code> — 337<br />
# <code>UNUSED_FUNC_RES.REWRITE.MINOR</code> — 44<br />
# <code>UNREACHABLE_CODE</code> — 28<br />
# <code>DEREF_AFTER_NULL.EX</code> — 27<br />
# <code>NULL_AFTER_DEREF</code> — 27<br />
</blockquote><code>Unspecified</code> в <code>by_severity</code> — маркеры без ручного ревью, а не «низкий приоритет». Поле <code>by_checker</code> не сортируется, на большом снимке оно может содержать более 100 ключей — чтобы получить именно топ-N, следует явно сформулировать запрос: «топ-5 детекторов».<br />
<br />
=== Тренд по нескольким снимкам ===<br />
<blockquote>Как у openssl менялось число предупреждений за последние пять снимков? Покажи таблицей.</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — взять список<br />
# <code>get_project_stats()</code> × 5 — по каждому из последних пяти снимков<br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
{| class="wikitable"<br />
|+<br />
!Снимок<br />
!Дата<br />
!Всего<br />
|-<br />
|2020-04-30 05:49<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:29<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:08<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:48<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:22<br />
|30.04.2020<br />
|1252<br />
|}<br />
</blockquote><br />
На демонстрационном стенде указанные пять снимков openssl импортированы с интервалом в 20 минут одного дня и полностью идентичны — поэтому динамика отсутствует. На реальном проекте с историей релизов значения будут изменяться.<br />
<br />
=== Найти срабатывания конкретного детектора ===<br />
<blockquote>Где в bash срабатывает PROC_USE.VULNERABLE? Покажи список — файл, строка, что именно ругается. Достаточно первых десяти.</blockquote>'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code><br />
# <code>get_markers(warnClass=["PROC_USE.VULNERABLE"])</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
# <code>/.build/lib/sh/tmpfile.c:160</code> — <code>mktemp()</code>, race condition. Рекомендуется <code>mkstemp()</code>.<br />
# <code>/.build/lib/readline/shell.c:151</code> — <code>getenv()</code>, значение может быть подменено.<br />
# <code>/.build/shell.c:415</code> — <code>getenv()</code> в <code>main()</code>.<br />
# <code>/.build/lib/readline/complete.c:1516</code> — <code>getenv()</code>.<br />
# <code>/.build/lib/sh/eaccess.c:115</code> — <code>strcat()</code>, рекомендуется <code>strncat()</code>. …<br />
</blockquote><br />
Фильтр <code>warnClass=["PROC_USE.VULNERABLE"]</code> охватывает все подклассы: <code>PROC_USE.VULNERABLE.TEMP</code>, <code>.GETENV</code>, <code>.STRCAT</code> и т. д. — всего 341 маркер. Несколько значений в одном параметре трактуются как логическое «ИЛИ»: <code>severity=["Critical","Major"]</code> возвращает маркеры обеих категорий.<br />
<br />
В ответе будет <code>total_count: 341, returned_count: 30, truncated: true</code> — это ожидаемое поведение. Модель видит общий объём по <code>total_count</code> и при необходимости сужает запрос или вызывает <code>get_markers(..., limit=0)</code>, чтобы получить полный список.<br />
<br />
=== Сравнить два снимка ===<br />
<blockquote>Возьми два последних снимка paho.mqtt.c — что между ними изменилось? Сколько новых предупреждений, сколько починили?</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — два последних<br />
# <code>get_diff(base_snapshot_id="72b3df7b-...", head_snapshot_id="b42cb563-...", level=0)</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote>Между двумя последними снимками paho.mqtt.c:<br />
<br />
* Новых: 12<br />
* Удалённых: 13<br />
* Изменённых: 99<br />
* Совпадающих: 185<br />
<br />
Удалено несколько больше, чем добавлено — общая картина практически не изменилась.</blockquote><br />
<br />
Категория <code>modified</code> — маркер, присутствующий в обоих снимках, у которого изменилось окружение (номер строки, контекст функции). Это не новая ошибка. На больших проектах рекомендуется начинать с <code>level=0</code> для получения статистики, при необходимости использовать <code>level=1</code> (только идентификаторы маркеров) и затем точечно вызывать <code>get_markers</code> с нужными фильтрами.<br />
<br />
<code>level=2</code> возвращает полные маркеры по категориям, причём каждая категория по умолчанию ограничена 20 маркерами. Категории располагаются внутри <code>markers</code>: <code>new_markers</code>, <code>missing_markers</code>, <code>modified_markers</code>, <code>matched_markers</code>. Структура ответа в JSON: <code><nowiki>{"markers": {"new_markers": {"total_count": N, "returned_count": ..., "truncated": ..., "markers": [...]}, ...}}</nowiki></code>. Если требуется полное содержимое категории, следует увеличить <code>limit</code> или выполнить отдельный вызов <code>get_markers</code> по нужным идентификаторам.<br />
<br />
=== Разобрать конкретное предупреждение ===<br />
<blockquote>В bash есть один подтверждённый критикал — что-то про разыменование указателя. Покажи код вокруг этого места и объясни в чём проблема.</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code> → <code>get_snapshots()</code> — найти снимок bash<br />
# <code>get_markers(severity=["Critical"], review=["Confirmed"])</code><br />
# <code>get_advanced_file_preview(file_path="/.build/execute_cmd.c", line=3327, before=10, after=10)</code><br />
<br />
'''Ответ модели:<blockquote>Маркер <code>DEREF_AFTER_NULL.LOOP</code> в функции <code>select_query()</code>, строка 3327:<br />
<code>for (l = list; l && --reply; l = l->next)<br />
<br />
;<br />
<br />
return (l->word->word); /* l может быть NULL после выхода из цикла */</code><br />
<br />
Если список заканчивается раньше, чем <code>reply</code> обнуляется, <code>l</code> станет <code>NULL</code> на последнем <code>l->next</code>, и следующий <code>l->word->word</code> — разыменование нулевого указателя.</blockquote><code>file_path</code> должен точно совпадать со значением, возвращённым маркером, включая ведущий префикс <code>/.build/...</code>. Это путь внутри сборочной директории Svacer, а не путь в исходном репозитории; соответствие в репозитории определяется по имени файла.<br />
<br />
Для одиночной разметки удобно сразу запрашивать полный маркер с трассами: <code>get_markers(..., severity=["Critical"], review=["Confirmed"], traces=True, checker_info=True)</code>. Флаги <code>traces</code> и <code>checker_info</code> указывают серверу включить соответствующие поля в ответ; в выдаче они сохраняются и при значении <code>fields</code> по умолчанию. Значение <code>fields=["*"]</code> требуется лишь в том случае, когда дополнительно нужны <code>tool</code> и <code>mtid</code> — служебные ключи, исключённые из компактного набора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_MCP&diff=3505Help:13-alpha MCP2026-05-21T10:02:59Z<p>Mitrofanov: /* Разобрать конкретное предупреждение */</p>
<hr />
<div>== Архитектура ==<br />
[https://modelcontextprotocol.io/docs/getting-started/intro MCP] — открытый стандарт, через который LLM-клиенты (Claude Desktop, Cursor, VS Code, OpenWebUI и др.) вызывают внешние инструменты. <br />
Svacer MCP соединяет одно с другим: 8 инструментов поверх публичного REST API Svacer, которые LLM выбирает и вызывает в ответ на обычный текстовый запрос. Вместо ручной последовательности «открыть UI, найти проект, выбрать снимок, применить фильтр» достаточно сформулировать вопрос в чате, например, «сколько критических предупреждений в последнем снимке bash?», и получить ответ. Необходимые вызовы инструментов модель выполняет самостоятельно.<br />
<br />
[[File:Архитектура MCP.png|thumb|none|x800px|alt=architectureMCP|Архитектура MCP-сервер]]<br />
<br />
Поток запроса: LLM-клиент отправляет MCP-вызов через STDIO или Streamable HTTP → <code>server.py</code> передаёт его в выбранный инструмент из <code>tools/</code> → инструмент проверяет параметры и обращается к <code>api_client.py</code> → клиент получает JWT от <code>auth.py</code> (модуль автоматически обновляет токен по истечении срока действия или при ответе 401) → запрос отправляется в Svacer REST API.<br />
<br />
== Установка ==<br />
Установка Svacer MCP, подключение клиентов и конфигурация.<br />
<br />
=== Требования ===<br />
<br />
* Python 3.10+<br />
* Доступ к Svacer-серверу: URL + логин/пароль<br />
<br />
=== Режим STDIO ===<br />
Подходит для настольных клиентов: Claude Desktop, Claude Code, Cursor, VS Code.<br />
<code>git clone <nowiki>https://gitlab.ispras.ru/svacerai/mcp.git</nowiki> && cd mcp<br />
<br />
python3 -m venv .venv<br />
.venv/bin/pip install -e .<br />
<br />
cp .env.example .env<br />
# Отредактировать .env — указать URL и учётные данные Svacer<br />
<br />
# Проверить запуск (сервер ожидает данные на stdin; для выхода — Ctrl+C)<br />
.venv/bin/svacer-mcp</code><br />
После <code>pip install -e .</code> в окружении становится доступна команда <code>svacer-mcp</code> — её указывают в конфигурации клиентов ниже.<br />
<br />
=== Режим HTTP (Docker) ===<br />
Подходит для веб-клиентов (OpenWebUI) и удалённого доступа.<br />
<br />
'''Требования:''' Docker, Docker Compose.<br />
<code>cp .env.example .env<br />
<br />
# В .env обязательно задать SVACER_MCP_TOKEN — без него сервер не запускается<br />
echo "SVACER_MCP_TOKEN=$(openssl rand -hex 32)" >> .env<br />
<br />
docker compose up -d<br />
<br />
# MCP endpoint: <nowiki>http://localhost:8002/mcp</nowiki><br />
# Клиенты передают заголовок: Authorization: Bearer <SVACER_MCP_TOKEN></code><br />
Внешний порт хоста задаётся переменной <code>MCP_PORT</code> (по умолчанию <code>8002</code>), внутри контейнера сервер всегда слушает порт <code>8000</code>.<br />
<br />
=== Подключение клиентов ===<br />
<br />
==== Claude Desktop ====<br />
Файл конфигурации: <code>~/.config/Claude/claude_desktop_config.json</code> (Linux) или <code>%APPDATA%\Claude\claude_desktop_config.json</code> (Windows).<br />
<br />
Укажите '''абсолютный путь''' к <code>svacer-mcp</code> из вашего venv (<code>which svacer-mcp</code> в активированном venv или <code>/path/to/mcp/.venv/bin/svacer-mcp</code>).<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Claude Code ====<br />
<code>claude mcp add svacer \<br />
-e SVACER_URL=<nowiki>https://your-svacer.example.com</nowiki> \<br />
-e SVACER_LOGIN=your-login \<br />
-e SVACER_PASSWORD=your-password \<br />
-- /path/to/mcp/.venv/bin/svacer-mcp</code><br />
<br />
==== VS Code ====<br />
Файл <code>.vscode/mcp.json</code> в корне рабочей директории:<br />
<code>{<br />
"servers": {<br />
"svacer": {<br />
"type": "stdio",<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Cursor ====<br />
Файл <code>.cursor/mcp.json</code> в корне проекта или глобально:<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== OpenWebUI ====<br />
<br />
# Развернуть через Docker (см. «Режим HTTP» выше).<br />
# Открыть '''Settings → Tools''' (или '''Admin Panel → Settings → Tools''').<br />
# Добавить сервер:<br />
#* <code><nowiki>http://localhost:8002/mcp</nowiki></code> — если OpenWebUI работает на хосте, снаружи Docker.<br />
#* <code><nowiki>http://svacer-mcp:8000/mcp</nowiki></code> — если OpenWebUI развёрнут в той же compose-сети, что и <code>svacer-mcp</code> (имя берётся из <code>docker-compose.yml</code> → service name, порт 8000 — внутренний порт контейнера).<br />
# Тип подключения: '''MCP (Streamable HTTP)'''.<br />
# В настройках инструмента указать заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code> (значение — то же, что в <code>.env</code> сервера).<br />
# Сохранить — инструменты появятся в чате.<br />
<br />
=== Конфигурация ===<br />
{| class="wikitable"<br />
!Переменная<br />
!По умолчанию<br />
!Описание<br />
|-<br />
|<code>SVACER_URL</code><br />
|<code><nowiki>https://svacer-demo.ispras.ru</nowiki></code><br />
|URL Svacer-сервера<br />
|-<br />
|<code>SVACER_LOGIN</code><br />
|<code>admin</code><br />
|Логин<br />
|-<br />
|<code>SVACER_PASSWORD</code><br />
|<code>admin</code><br />
|Пароль<br />
|-<br />
|<code>SVACER_TIMEOUT</code><br />
|<code>30</code><br />
|Тайм-аут HTTP-запросов к Svacer, секунды<br />
|-<br />
|<code>SVACER_TRANSPORT</code><br />
|<code>stdio</code><br />
|Режим транспорта: <code>stdio</code> или <code>http</code><br />
|-<br />
|<code>SVACER_HTTP_PORT</code><br />
|<code>8000</code><br />
|TCP-порт сервера в режиме HTTP (внутри контейнера)<br />
|-<br />
|<code>SVACER_MCP_TOKEN</code><br />
|''(не задано)''<br />
|Bearer-токен для клиентов <code>/mcp</code>. Обязателен при <code>SVACER_TRANSPORT=http</code>, в режиме STDIO игнорируется. Генерация: <code>openssl rand -hex 32</code><br />
|-<br />
|<code>SVACER_MCP_RESOURCE_URL</code><br />
|<code><nowiki>http://localhost</nowiki>:<HTTP_PORT></code><br />
|Публичный URL MCP-сервера для заголовка <code>WWW-Authenticate</code> (<nowiki>RFC 9728</nowiki>). Задаётся при работе за обратным прокси<br />
|-<br />
|<code>SVACER_TOOLS</code><br />
|''(не задано)''<br />
|Список инструментов через запятую. Если не задано, регистрируются все 8<br />
|-<br />
|<code>MCP_PORT</code><br />
|<code>8002</code><br />
|Внешний порт хоста при запуске через <code>docker compose</code> (отображается на внутренний <code>SVACER_HTTP_PORT</code>)<br />
|}<br />
Переменные читаются из <code>.env</code> или из окружения. Для STDIO-клиентов их можно указать в секции <code>env</code> конфигурации клиента.<br />
<br />
==== Ограничение набора инструментов ====<br />
Чтобы запустить сервер с подмножеством инструментов (например, для уменьшения объёма контекста у модели или разграничения доступа), задайте <code>SVACER_TOOLS</code>:<br />
<code>SVACER_TOOLS=get_projects,get_snapshots,get_markers</code><br />
Допустимые имена: <code>get_projects</code>, <code>get_snapshots</code>, <code>get_warnings</code>, <code>get_markers</code>, <code>get_project_stats</code>, <code>get_project_groups</code>, <code>get_advanced_file_preview</code>, <code>get_diff</code>. Неизвестное имя в списке приводит к ошибке при запуске. Если переменная пустая или не задана, регистрируются все 8 инструментов.<br />
<br />
==== Несколько экземпляров сервера ====<br />
Параллельный запуск нескольких MCP-серверов поддерживается без ограничений.<br />
<br />
* В режиме STDIO каждая запись в конфигурации клиента описывает отдельный процесс — несколько подключений к разным экземплярам Svacer задаются простым перечислением.<br />
* В режиме HTTP запускаются независимые контейнеры на разных хост-портах: например, <code>MCP_PORT=8002</code> для одного экземпляра и <code>MCP_PORT=8003</code> для другого. Для каждого контейнера задаётся собственный <code>SVACER_MCP_TOKEN</code>.<br />
<br />
=== Безопасность ===<br />
<br />
* '''STDIO''': сервер не открывает сетевых портов и обменивается данными через стандартные потоки ввода/вывода процесса.<br />
* '''Streamable HTTP''': эндпоинт <code>/mcp</code> требует заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code>. Запросы без токена или с неверным значением получают ответ <code>401</code> и заголовок <code>WWW-Authenticate: Bearer ...</code>. Токен является разделяемым секретом и не заменяет TLS, а дополняет его: при работе за обратным прокси необходимо использовать HTTPS, а сам токен передавать только по защищённому каналу.<br />
* Без <code>SVACER_MCP_TOKEN</code> HTTP-сервер не запускается.<br />
* Учётные данные <code>admin/admin</code> предназначены только для тестового стенда. В рабочем окружении необходимо задать собственные логин и пароль через переменные окружения.<br />
* Файл <code>.env</code> не должен добавляться в систему контроля версий.<br />
<br />
==== Передача токена клиентом ====<br />
Большинство HTTP-клиентов MCP (OpenWebUI и др.) позволяют задать произвольный заголовок <code>Authorization</code> в настройках инструмента — указывается значение <code>Bearer <токен></code>. Для ручной проверки:<br />
<code>curl -H "Authorization: Bearer $SVACER_MCP_TOKEN" \<br />
<nowiki> </nowiki> -H 'Content-Type: application/json' \<br />
<nowiki> </nowiki> -H 'Accept: application/json, text/event-stream' \<br />
<nowiki> </nowiki> -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}' \<br />
<nowiki> </nowiki> <nowiki>http://localhost:8002/mcp</nowiki></code><br />
<br />
== Инструменты ==<br />
Справочник по 8 инструментам Svacer MCP. Типичный порядок вызовов: <code>get_projects</code> → <code>get_snapshots</code> → любой из аналитических инструментов.<br />
{| class="wikitable"<br />
!Инструмент<br />
!Назначение<br />
|-<br />
|<code>get_projects</code><br />
|Список проектов с ветками — точка входа<br />
|-<br />
|<code>get_snapshots</code><br />
|Снимки конкретной ветки, от нового к старому<br />
|-<br />
|<code>get_project_stats</code><br />
|Агрегированные метрики снимка: severity / review / checker<br />
|-<br />
|<code>get_markers</code><br />
|Компактный список маркеров с серверной фильтрацией<br />
|-<br />
|<code>get_warnings</code><br />
|Полные предупреждения с трассами и историей ревью<br />
|-<br />
|<code>get_diff</code><br />
|Сравнение двух снимков: new / missing / modified / matched<br />
|-<br />
|<code>get_advanced_file_preview</code><br />
|Фрагмент исходного кода вокруг строки<br />
|-<br />
|<code>get_project_groups</code><br />
|Группа проектов по имени или UUID<br />
|}<br />
<br />
=== get_projects ===<br />
Список всех проектов с ветками. Точка входа: с этого вызова начинается практически любой сценарий — он возвращает <code>project_id</code> и <code>branch_id</code>, необходимые для последующих запросов.<br />
<br />
'''Параметров нет.'''<br />
<br />
'''Вызов:'''<br />
<code>get_projects()</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"project_id": "91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
"project_name": "bash",<br />
"created": "2021-12-13T13:22:42.122456Z",<br />
"created_by": "admin",<br />
"branches": [<br />
{<br />
"branch_id": "77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
"branch_name": "master",<br />
"created": "2021-12-13T13:22:42.394812Z"<br />
}<br />
]<br />
}<br />
]</code><br />
----<br />
<br />
=== get_snapshots ===<br />
Список снимков для конкретной ветки проекта, от нового к старому.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>name_filter</code><br />
|string<br />
|нет<br />
|Подстрока или regex для фильтра по имени снимка<br />
|}<br />
'''Вызов:'''<br />
<code>get_snapshots(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4"<br />
)</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"snapshot_id": "b42cb563-86f4-4f96-900a-7782163327c9",<br />
"name": "Snapshot 2020-03-25 09:09:41 +0300",<br />
"import_time": "2020-03-25T09:09:41.837296Z",<br />
"commit_hash": null,<br />
"markers_count": 297,<br />
"link": "<nowiki>https://svacer-demo.ispras.ru/</nowiki>..."<br />
}<br />
]</code><br />
----<br />
<br />
=== get_project_stats ===<br />
Агрегированные метрики по снимку: общее количество предупреждений, распределение по критичности, по статусу ревью, по детекторам. Наиболее быстрый способ получить общую картину по проекту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_stats(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9"<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_warnings": 771,<br />
"by_severity": {<br />
"Critical": 1,<br />
"Major": 1,<br />
"Unspecified": 769<br />
},<br />
"by_review_status": {<br />
"Confirmed": 1,<br />
"False Positive": 1,<br />
"Undecided": 767,<br />
"Unclear": 1,<br />
"Won't fix": 1<br />
},<br />
"by_checker": {<br />
"PROC_USE.VULNERABLE": 337,<br />
"UNUSED_FUNC_RES.REWRITE.MINOR": 44,<br />
"UNREACHABLE_CODE": 28,<br />
"DEREF_AFTER_NULL.EX": 27,<br />
"NULL_AFTER_DEREF": 27<br />
}<br />
}</code><br />
----<br />
<br />
=== get_markers ===<br />
Компактный список маркеров с серверной фильтрацией. Основной инструмент для перечисления и обзора: его следует предпочитать <code>get_warnings</code>, когда не требуются развёрнутые поля — трассы и история ревью.<br />
<br />
По умолчанию ответ ограничен 30 маркерами и содержит компактный набор полей. Подробнее об ограничении объёма см. раздел Про объём ответа в сценариях.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора (<code>DEREF_AFTER_NULL</code>, …)<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы маркеров<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю изменений ревью<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии к маркеру<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра из веб-интерфейса Svacer<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров в ответе (по умолчанию <code>30</code>). Значение <code>0</code> снимает ограничение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|Список разрешённых полей маркера верхнего уровня. По умолчанию — компактный набор <code>id, warnClass, file, line, msg, function, review</code>. Значение <code>["*"]</code> возвращает все поля коннектора (<code>id, warnClass, file, line, msg, tool, function, mtid, review</code>, а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены). Допустим и произвольный список — например, <code>["id","warnClass"]</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_markers(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
warnClass=["PROC_USE.VULNERABLE"]<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 341,<br />
"returned_count": 30,<br />
"truncated": true,<br />
"filters_applied": {"warnClass": ["PROC_USE.VULNERABLE"]},<br />
"markers": [<br />
{<br />
"id": "e05bb35b-a95e-4eb2-85ae-3101b788f07d",<br />
"warnClass": "PROC_USE.VULNERABLE.TEMP",<br />
"file": "/.build/lib/sh/tmpfile.c",<br />
"line": 160,<br />
"msg": "Use of vulnerable function 'mktemp' at tmpfile.c:160. ...",<br />
"function": "sh_mktmpname",<br />
"review": null<br />
}<br />
]<br />
}</code><br />
<code>total_count</code> отражает количество маркеров, удовлетворяющих фильтру до применения ограничения; <code>returned_count</code> — количество маркеров, фактически содержащихся в <code>markers</code>. При <code>truncated: true</code> следует либо сузить фильтры (<code>severity</code>, <code>warnClass</code>, <code>file</code>), либо передать <code>limit=0</code> для получения полного списка. Поля <code>tool</code> и <code>mtid</code> возвращаются только при <code>fields=["*"]</code>.<br />
----<br />
<br />
=== get_warnings ===<br />
Полные предупреждения с детальной разметкой. Ответ значительно объёмнее, чем у <code>get_markers</code>, поэтому инструмент следует использовать только тогда, когда нужны поля, отсутствующие в компактной форме: <code>traces</code>, <code>review_history</code>, <code>checker_info</code>, <code>comment_history</code>.<br />
<br />
Лимит по умолчанию — 30; при включённых <code>traces</code>, <code>review_history</code> или <code>comment_history</code> он автоматически снижается до 8, поскольку такие предупреждения существенно объёмнее.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы. Активирует режим расширенных полей (лимит по умолчанию — 8)<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю ревью. Режим расширенных полей<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии. Режим расширенных полей<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество предупреждений в ответе. По умолчанию — <code>30</code>, в режиме расширенных полей — <code>8</code>. Значение <code>0</code> снимает ограничение. Явно заданное <code>limit</code> отменяет автоматическое снижение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_warnings(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
severity=["Critical"],<br />
review_history=True,<br />
traces=True<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 1,<br />
"returned_count": 1,<br />
"truncated": false,<br />
"filters_applied": {"severity": ["Critical"], "traces": true, "review_history": true},<br />
"warnings": [<br />
{<br />
"id": "a3f21c90-1d4e-4b82-9f63-7c8e5d2a1b09",<br />
"warnClass": "DEREF_AFTER_NULL.LOOP",<br />
"file": "/.build/execute_cmd.c",<br />
"line": 3327,<br />
"msg": "Possible null pointer dereference of 'l' after loop exit.",<br />
"function": "select_query",<br />
"review": {"status": "Confirmed", "severity": "Critical"},<br />
"review_history": [{"status": "Confirmed", "changed_by": "admin", "changed_at": "2021-12-13T14:00:00Z"}],<br />
"traces": [{"file": "/.build/execute_cmd.c", "line": 3320, "msg": "Loop starts here; 'l' may exhaust the list."}]<br />
}<br />
]<br />
}</code><br />
----<br />
<br />
=== get_diff ===<br />
Сравнение двух снимков. Категории располагаются под ключом <code>markers</code>: <code>new_markers</code> (появилось в новом снимке), <code>missing_markers</code> (исчезло из нового), <code>modified_markers</code> (тот же идентификатор, изменился контекст), <code>matched_markers</code> (совпало в обоих). Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно UUID снимков.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>base_snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|Старый снимок<br />
|-<br />
|<code>head_snapshot_id</code><br />
|string (UUID)<br />
|нет<br />
|Новый снимок; если не указан, сравнение выполняется с предыдущим по времени<br />
|-<br />
|<code>level</code><br />
|int<br />
|нет<br />
|<code>0</code> — только статистика; <code>1</code> — статистика и идентификаторы маркеров; <code>2</code> — полные маркеры по категориям<br />
|-<br />
|<code>checker_info</code><br />
|bool<br />
|нет<br />
|Метаданные детекторов для маркеров (только при <code>level >= 2</code>)<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров '''на каждую категорию''' при <code>level >= 2</code>. По умолчанию — <code>20</code>, значение <code>0</code> снимает ограничение. Параметр игнорируется при <code>level < 2</code><br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code>/<code>get_warnings</code>. Применяется к маркерам внутри категорий при <code>level >= 2</code><br />
|}<br />
'''Вызов (<code>level=0</code>):'''<br />
<code>get_diff(<br />
base_snapshot_id="72b3df7b-c15a-4e3d-8f92-a041dc6e5b87",<br />
head_snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
level=0<br />
)</code><br />
'''Ответ (<code>level=0</code>):'''<br />
<code>{<br />
"stats": {<br />
"context1": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-20 ..."},<br />
"context2": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-25 ..."},<br />
"scope": ["NEW", "MISSING", "MATCHED", "MODIFIED"],<br />
"new": 9,<br />
"missing": 12,<br />
"modified": 98,<br />
"matched": 187<br />
}<br />
}</code><br />
'''Ответ (<code>level=2</code>)''' — каждая категория внутри <code>markers</code> оформляется и ограничивается независимо:<br />
<code>{<br />
"stats": {"new": 50, "missing": 5, "modified": 0, "matched": 187},<br />
"markers": {<br />
"new_markers": {<br />
"total_count": 50,<br />
"returned_count": 20,<br />
"truncated": true,<br />
"markers": [<br />
{"id": "a3f21c90-...", "warnClass": "DEREF_AFTER_NULL.LOOP", "file": "...", "line": 3327, "msg": "...", "function": "select_query", "review": null}<br />
]<br />
},<br />
"missing_markers": {"total_count": 5, "returned_count": 5, "truncated": false, "markers": [...]},<br />
"modified_markers": {"total_count": 0, "returned_count": 0, "truncated": false, "markers": []},<br />
"matched_markers": {"total_count": 187, "returned_count": 20, "truncated": true, "markers": [...]}<br />
}<br />
}</code><br />
Если требуется полное содержимое категории, следует увеличить <code>limit</code> либо запросить нужные идентификаторы отдельным вызовом <code>get_markers</code>. Маркеры внутри категорий проходят ту же компактную обработку, что и в <code>get_warnings</code>: значение <code>fields=["*"]</code> возвращает фиксированный набор полей коннектора, а не произвольные «сырые» поля API.<br />
----<br />
<br />
=== get_advanced_file_preview ===<br />
Фрагмент исходного кода из снимка вокруг указанной строки. Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно идентификатора снимка и пути к файлу.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>file_path</code><br />
|string<br />
|да<br />
|Путь к файлу в том виде, в котором его возвращают <code>get_markers</code> и <code>get_warnings</code><br />
|-<br />
|<code>line</code><br />
|int<br />
|нет<br />
|Центральная строка, нумерация с 1 (по умолчанию <code>1</code>)<br />
|-<br />
|<code>before</code><br />
|int<br />
|нет<br />
|Количество строк до центральной (по умолчанию <code>0</code>)<br />
|-<br />
|<code>after</code><br />
|int<br />
|нет<br />
|Количество строк после центральной (по умолчанию <code>99999</code> — до конца файла)<br />
|}<br />
'''Вызов:'''<br />
<code>get_advanced_file_preview(<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
file_path="/.build/execute_cmd.c",<br />
line=3327,<br />
before=10,<br />
after=10<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"line": 3327,<br />
"content": " for (l = list; l && --reply; l = l->next)\n\t;\n return (l->word->word);\n",<br />
"total_lines": 6082<br />
}</code><br />
----<br />
<br />
=== get_project_groups ===<br />
Получить группу проектов по имени или UUID. Группы объединяют проекты в логические блоки — например, по команде или продукту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>name_or_id</code><br />
|string<br />
|да<br />
|Имя группы или её UUID<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_groups(name_or_id="Linux Tools")</code><br />
'''Ответ:'''<br />
<code>{<br />
"project_group_id": "c4f8a2d1-3b7e-4f90-82ac-1d5e8f2b6c04",<br />
"project_group_name": "Linux Tools",<br />
"projects": [<br />
{"id": "91630e84-db2f-4d8c-8716-68b7fdf17a66", "name": "bash"},<br />
{"id": "d3a17f52-...", "name": "coreutils"}<br />
]<br />
}</code><br />
<code>projects[].id</code> — это <code>project_id</code>, который далее передаётся в <code>get_snapshots</code>. Группы и проекты — разные сущности; идентификатор группы и идентификатор проекта не взаимозаменяемы.<br />
<br />
== Примеры сценариев ==<br />
Приведённые ниже запросы выполнены на демонстрационном стенде <code>svacer-demo.ispras.ru</code> с использованием OpenWebUI и модели <code>qwen3-coder:30b</code>. В любом другом MCP-клиенте с моделью достаточной мощности порядок вызовов будет аналогичным.<br />
<br />
=== Про объём ответа ===<br />
<code>get_markers</code>, <code>get_warnings</code> и <code>get_diff(level=2)</code> по умолчанию ограничивают объём ответа, чтобы не перегружать контекст модели:<br />
<br />
* <code>get_markers</code> и <code>get_warnings</code> — 30 маркеров по умолчанию. Если у <code>get_warnings</code> включены <code>traces</code>, <code>review_history</code> или <code>comment_history</code>, лимит снижается до 8, поскольку такие маркеры значительно объёмнее.<br />
* <code>get_diff(level=2)</code> — 20 маркеров на каждую категорию внутри <code>markers</code> (<code>new_markers</code>/<code>missing_markers</code>/<code>modified_markers</code>/<code>matched_markers</code>).<br />
<br />
В ответе присутствуют поля <code>total_count</code>, <code>returned_count</code>, <code>truncated</code>. При <code>truncated: true</code> есть два варианта действий: сузить фильтр (<code>severity</code>, <code>warnClass</code>, <code>file</code>) либо явно увеличить <code>limit</code> (значение <code>limit=0</code> полностью снимает ограничение).<br />
<br />
Поле <code>fields</code> определяет, какие ключи маркера возвращаются. По умолчанию применяется компактный набор <code>id, warnClass, file, line, msg, function, review</code> (а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены логическими флагами и пришли с сервера). Для полного маркера со всеми служебными ключами — <code>fields=["*"]</code>. Для произвольной выборки — список полей верхнего уровня, например <code>fields=["id","warnClass"]</code>. Поле <code>review</code> — объект <code>{status, severity, action}</code>; вложенные ключи в <code>fields</code> не поддерживаются, поэтому объект <code>review</code> запрашивается целиком.<br />
<br />
=== Перечислить все проекты ===<br />
<blockquote>Какие проекты есть в Svacer?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
<br />
'''Ответ модели:'''<blockquote>В Svacer доступно 6 проектов: bash, openssl, paho.mqtt.c, coturn, zstd, darpa. У каждого — одна ветка <code>master</code>.</blockquote><br />
<br />
=== Посмотреть снимки проекта ===<br />
<blockquote>Какие снимки есть у paho.mqtt.c? Самый свежий когда?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code> — найти <code>project_id</code> и <code>branch_id</code><br />
# <code>get_snapshots(project_id=..., branch_id=...)</code><br />
<br />
'''Ответ модели:'''<blockquote>У paho.mqtt.c 3 снимка. Самый свежий — «Snapshot 2020-03-25 09:09:41 +0300» (297 маркеров). Предыдущий — 20 марта (306 маркеров).</blockquote>Поле <code>commit_hash</code> может принимать значение <code>null</code>, если проект не сохраняет хэш коммита в <code>custom_properties</code>. Имена снимков произвольны: одни проекты записывают в имя дату, другие — коммит, третьи — свободный текст.<br />
<br />
=== Сводка по проекту ===<br />
<blockquote>Что в bash в последнем снимке? Сколько всего предупреждений, есть ли критические, какие топ-детекторы?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots(project_id, branch_id)</code> — взять последний снимок<br />
# <code>get_project_stats(project_id, branch_id, snapshot_id)</code><br />
<br />
'''Ответ модели:'''<blockquote>В последнем снимке bash содержится 771 предупреждение:<br />
<br />
* Критических: 1 (Confirmed)<br />
* Major: 1 (Won't fix)<br />
* Остальные: 769 (Unspecified — не ревьюились)<br />
<br />
Топ-детекторы по количеству:<br />
<br />
# <code>PROC_USE.VULNERABLE</code> — 337<br />
# <code>UNUSED_FUNC_RES.REWRITE.MINOR</code> — 44<br />
# <code>UNREACHABLE_CODE</code> — 28<br />
# <code>DEREF_AFTER_NULL.EX</code> — 27<br />
# <code>NULL_AFTER_DEREF</code> — 27<br />
</blockquote><code>Unspecified</code> в <code>by_severity</code> — маркеры без ручного ревью, а не «низкий приоритет». Поле <code>by_checker</code> не сортируется, на большом снимке оно может содержать более 100 ключей — чтобы получить именно топ-N, следует явно сформулировать запрос: «топ-5 детекторов».<br />
<br />
=== Тренд по нескольким снимкам ===<br />
<blockquote>Как у openssl менялось число предупреждений за последние пять снимков? Покажи таблицей.</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — взять список<br />
# <code>get_project_stats()</code> × 5 — по каждому из последних пяти снимков<br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
{| class="wikitable"<br />
|+<br />
!Снимок<br />
!Дата<br />
!Всего<br />
|-<br />
|2020-04-30 05:49<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:29<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:08<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:48<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:22<br />
|30.04.2020<br />
|1252<br />
|}<br />
</blockquote><br />
На демонстрационном стенде указанные пять снимков openssl импортированы с интервалом в 20 минут одного дня и полностью идентичны — поэтому динамика отсутствует. На реальном проекте с историей релизов значения будут изменяться.<br />
<br />
=== Найти срабатывания конкретного детектора ===<br />
<blockquote>Где в bash срабатывает PROC_USE.VULNERABLE? Покажи список — файл, строка, что именно ругается. Достаточно первых десяти.</blockquote>'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code><br />
# <code>get_markers(warnClass=["PROC_USE.VULNERABLE"])</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
# <code>/.build/lib/sh/tmpfile.c:160</code> — <code>mktemp()</code>, race condition. Рекомендуется <code>mkstemp()</code>.<br />
# <code>/.build/lib/readline/shell.c:151</code> — <code>getenv()</code>, значение может быть подменено.<br />
# <code>/.build/shell.c:415</code> — <code>getenv()</code> в <code>main()</code>.<br />
# <code>/.build/lib/readline/complete.c:1516</code> — <code>getenv()</code>.<br />
# <code>/.build/lib/sh/eaccess.c:115</code> — <code>strcat()</code>, рекомендуется <code>strncat()</code>. …<br />
</blockquote><br />
Фильтр <code>warnClass=["PROC_USE.VULNERABLE"]</code> охватывает все подклассы: <code>PROC_USE.VULNERABLE.TEMP</code>, <code>.GETENV</code>, <code>.STRCAT</code> и т. д. — всего 341 маркер. Несколько значений в одном параметре трактуются как логическое «ИЛИ»: <code>severity=["Critical","Major"]</code> возвращает маркеры обеих категорий.<br />
<br />
В ответе будет <code>total_count: 341, returned_count: 30, truncated: true</code> — это ожидаемое поведение. Модель видит общий объём по <code>total_count</code> и при необходимости сужает запрос или вызывает <code>get_markers(..., limit=0)</code>, чтобы получить полный список.<br />
<br />
=== Сравнить два снимка ===<br />
<blockquote>Возьми два последних снимка paho.mqtt.c — что между ними изменилось? Сколько новых предупреждений, сколько починили?</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — два последних<br />
# <code>get_diff(base_snapshot_id="72b3df7b-...", head_snapshot_id="b42cb563-...", level=0)</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote>Между двумя последними снимками paho.mqtt.c:<br />
<br />
* Новых: 12<br />
* Удалённых: 13<br />
* Изменённых: 99<br />
* Совпадающих: 185<br />
<br />
Удалено несколько больше, чем добавлено — общая картина практически не изменилась.</blockquote><br />
<br />
Категория <code>modified</code> — маркер, присутствующий в обоих снимках, у которого изменилось окружение (номер строки, контекст функции). Это не новая ошибка. На больших проектах рекомендуется начинать с <code>level=0</code> для получения статистики, при необходимости использовать <code>level=1</code> (только идентификаторы маркеров) и затем точечно вызывать <code>get_markers</code> с нужными фильтрами.<br />
<br />
<code>level=2</code> возвращает полные маркеры по категориям, причём каждая категория по умолчанию ограничена 20 маркерами. Категории располагаются внутри <code>markers</code>: <code>new_markers</code>, <code>missing_markers</code>, <code>modified_markers</code>, <code>matched_markers</code>. Структура ответа в JSON: <code><nowiki>{"markers": {"new_markers": {"total_count": N, "returned_count": ..., "truncated": ..., "markers": [...]}, ...}}</nowiki></code>. Если требуется полное содержимое категории, следует увеличить <code>limit</code> или выполнить отдельный вызов <code>get_markers</code> по нужным идентификаторам.<br />
<br />
=== Разобрать конкретное предупреждение ===<br />
<blockquote>В bash есть один подтверждённый критикал — что-то про разыменование указателя. Покажи код вокруг этого места и объясни в чём проблема.</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code> → <code>get_snapshots()</code> — найти снимок bash<br />
# <code>get_markers(severity=["Critical"], review=["Confirmed"])</code><br />
# <code>get_advanced_file_preview(file_path="/.build/execute_cmd.c", line=3327, before=10, after=10)</code><br />
<br />
'''Ответ модели:<blockquote>Маркер <code>DEREF_AFTER_NULL.LOOP</code> в функции <code>select_query()</code>, строка 3327:<br />
for (l = list; l && --reply; l = l->next)<br />
<br />
;<br />
<br />
return (l->word->word); /* l может быть NULL после выхода из цикла */<br />
<br />
Если список заканчивается раньше, чем <code>reply</code> обнуляется, <code>l</code> станет <code>NULL</code> на последнем <code>l->next</code>, и следующий <code>l->word->word</code> — разыменование нулевого указателя.</blockquote><code>file_path</code> должен точно совпадать со значением, возвращённым маркером, включая ведущий префикс <code>/.build/...</code>. Это путь внутри сборочной директории Svacer, а не путь в исходном репозитории; соответствие в репозитории определяется по имени файла.<br />
<br />
Для одиночной разметки удобно сразу запрашивать полный маркер с трассами: <code>get_markers(..., severity=["Critical"], review=["Confirmed"], traces=True, checker_info=True)</code>. Флаги <code>traces</code> и <code>checker_info</code> указывают серверу включить соответствующие поля в ответ; в выдаче они сохраняются и при значении <code>fields</code> по умолчанию. Значение <code>fields=["*"]</code> требуется лишь в том случае, когда дополнительно нужны <code>tool</code> и <code>mtid</code> — служебные ключи, исключённые из компактного набора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_MCP&diff=3504Help:13-alpha MCP2026-05-21T10:01:23Z<p>Mitrofanov: /* Разобрать конкретное предупреждение */</p>
<hr />
<div>== Архитектура ==<br />
[https://modelcontextprotocol.io/docs/getting-started/intro MCP] — открытый стандарт, через который LLM-клиенты (Claude Desktop, Cursor, VS Code, OpenWebUI и др.) вызывают внешние инструменты. <br />
Svacer MCP соединяет одно с другим: 8 инструментов поверх публичного REST API Svacer, которые LLM выбирает и вызывает в ответ на обычный текстовый запрос. Вместо ручной последовательности «открыть UI, найти проект, выбрать снимок, применить фильтр» достаточно сформулировать вопрос в чате, например, «сколько критических предупреждений в последнем снимке bash?», и получить ответ. Необходимые вызовы инструментов модель выполняет самостоятельно.<br />
<br />
[[File:Архитектура MCP.png|thumb|none|x800px|alt=architectureMCP|Архитектура MCP-сервер]]<br />
<br />
Поток запроса: LLM-клиент отправляет MCP-вызов через STDIO или Streamable HTTP → <code>server.py</code> передаёт его в выбранный инструмент из <code>tools/</code> → инструмент проверяет параметры и обращается к <code>api_client.py</code> → клиент получает JWT от <code>auth.py</code> (модуль автоматически обновляет токен по истечении срока действия или при ответе 401) → запрос отправляется в Svacer REST API.<br />
<br />
== Установка ==<br />
Установка Svacer MCP, подключение клиентов и конфигурация.<br />
<br />
=== Требования ===<br />
<br />
* Python 3.10+<br />
* Доступ к Svacer-серверу: URL + логин/пароль<br />
<br />
=== Режим STDIO ===<br />
Подходит для настольных клиентов: Claude Desktop, Claude Code, Cursor, VS Code.<br />
<code>git clone <nowiki>https://gitlab.ispras.ru/svacerai/mcp.git</nowiki> && cd mcp<br />
<br />
python3 -m venv .venv<br />
.venv/bin/pip install -e .<br />
<br />
cp .env.example .env<br />
# Отредактировать .env — указать URL и учётные данные Svacer<br />
<br />
# Проверить запуск (сервер ожидает данные на stdin; для выхода — Ctrl+C)<br />
.venv/bin/svacer-mcp</code><br />
После <code>pip install -e .</code> в окружении становится доступна команда <code>svacer-mcp</code> — её указывают в конфигурации клиентов ниже.<br />
<br />
=== Режим HTTP (Docker) ===<br />
Подходит для веб-клиентов (OpenWebUI) и удалённого доступа.<br />
<br />
'''Требования:''' Docker, Docker Compose.<br />
<code>cp .env.example .env<br />
<br />
# В .env обязательно задать SVACER_MCP_TOKEN — без него сервер не запускается<br />
echo "SVACER_MCP_TOKEN=$(openssl rand -hex 32)" >> .env<br />
<br />
docker compose up -d<br />
<br />
# MCP endpoint: <nowiki>http://localhost:8002/mcp</nowiki><br />
# Клиенты передают заголовок: Authorization: Bearer <SVACER_MCP_TOKEN></code><br />
Внешний порт хоста задаётся переменной <code>MCP_PORT</code> (по умолчанию <code>8002</code>), внутри контейнера сервер всегда слушает порт <code>8000</code>.<br />
<br />
=== Подключение клиентов ===<br />
<br />
==== Claude Desktop ====<br />
Файл конфигурации: <code>~/.config/Claude/claude_desktop_config.json</code> (Linux) или <code>%APPDATA%\Claude\claude_desktop_config.json</code> (Windows).<br />
<br />
Укажите '''абсолютный путь''' к <code>svacer-mcp</code> из вашего venv (<code>which svacer-mcp</code> в активированном venv или <code>/path/to/mcp/.venv/bin/svacer-mcp</code>).<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Claude Code ====<br />
<code>claude mcp add svacer \<br />
-e SVACER_URL=<nowiki>https://your-svacer.example.com</nowiki> \<br />
-e SVACER_LOGIN=your-login \<br />
-e SVACER_PASSWORD=your-password \<br />
-- /path/to/mcp/.venv/bin/svacer-mcp</code><br />
<br />
==== VS Code ====<br />
Файл <code>.vscode/mcp.json</code> в корне рабочей директории:<br />
<code>{<br />
"servers": {<br />
"svacer": {<br />
"type": "stdio",<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Cursor ====<br />
Файл <code>.cursor/mcp.json</code> в корне проекта или глобально:<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== OpenWebUI ====<br />
<br />
# Развернуть через Docker (см. «Режим HTTP» выше).<br />
# Открыть '''Settings → Tools''' (или '''Admin Panel → Settings → Tools''').<br />
# Добавить сервер:<br />
#* <code><nowiki>http://localhost:8002/mcp</nowiki></code> — если OpenWebUI работает на хосте, снаружи Docker.<br />
#* <code><nowiki>http://svacer-mcp:8000/mcp</nowiki></code> — если OpenWebUI развёрнут в той же compose-сети, что и <code>svacer-mcp</code> (имя берётся из <code>docker-compose.yml</code> → service name, порт 8000 — внутренний порт контейнера).<br />
# Тип подключения: '''MCP (Streamable HTTP)'''.<br />
# В настройках инструмента указать заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code> (значение — то же, что в <code>.env</code> сервера).<br />
# Сохранить — инструменты появятся в чате.<br />
<br />
=== Конфигурация ===<br />
{| class="wikitable"<br />
!Переменная<br />
!По умолчанию<br />
!Описание<br />
|-<br />
|<code>SVACER_URL</code><br />
|<code><nowiki>https://svacer-demo.ispras.ru</nowiki></code><br />
|URL Svacer-сервера<br />
|-<br />
|<code>SVACER_LOGIN</code><br />
|<code>admin</code><br />
|Логин<br />
|-<br />
|<code>SVACER_PASSWORD</code><br />
|<code>admin</code><br />
|Пароль<br />
|-<br />
|<code>SVACER_TIMEOUT</code><br />
|<code>30</code><br />
|Тайм-аут HTTP-запросов к Svacer, секунды<br />
|-<br />
|<code>SVACER_TRANSPORT</code><br />
|<code>stdio</code><br />
|Режим транспорта: <code>stdio</code> или <code>http</code><br />
|-<br />
|<code>SVACER_HTTP_PORT</code><br />
|<code>8000</code><br />
|TCP-порт сервера в режиме HTTP (внутри контейнера)<br />
|-<br />
|<code>SVACER_MCP_TOKEN</code><br />
|''(не задано)''<br />
|Bearer-токен для клиентов <code>/mcp</code>. Обязателен при <code>SVACER_TRANSPORT=http</code>, в режиме STDIO игнорируется. Генерация: <code>openssl rand -hex 32</code><br />
|-<br />
|<code>SVACER_MCP_RESOURCE_URL</code><br />
|<code><nowiki>http://localhost</nowiki>:<HTTP_PORT></code><br />
|Публичный URL MCP-сервера для заголовка <code>WWW-Authenticate</code> (<nowiki>RFC 9728</nowiki>). Задаётся при работе за обратным прокси<br />
|-<br />
|<code>SVACER_TOOLS</code><br />
|''(не задано)''<br />
|Список инструментов через запятую. Если не задано, регистрируются все 8<br />
|-<br />
|<code>MCP_PORT</code><br />
|<code>8002</code><br />
|Внешний порт хоста при запуске через <code>docker compose</code> (отображается на внутренний <code>SVACER_HTTP_PORT</code>)<br />
|}<br />
Переменные читаются из <code>.env</code> или из окружения. Для STDIO-клиентов их можно указать в секции <code>env</code> конфигурации клиента.<br />
<br />
==== Ограничение набора инструментов ====<br />
Чтобы запустить сервер с подмножеством инструментов (например, для уменьшения объёма контекста у модели или разграничения доступа), задайте <code>SVACER_TOOLS</code>:<br />
<code>SVACER_TOOLS=get_projects,get_snapshots,get_markers</code><br />
Допустимые имена: <code>get_projects</code>, <code>get_snapshots</code>, <code>get_warnings</code>, <code>get_markers</code>, <code>get_project_stats</code>, <code>get_project_groups</code>, <code>get_advanced_file_preview</code>, <code>get_diff</code>. Неизвестное имя в списке приводит к ошибке при запуске. Если переменная пустая или не задана, регистрируются все 8 инструментов.<br />
<br />
==== Несколько экземпляров сервера ====<br />
Параллельный запуск нескольких MCP-серверов поддерживается без ограничений.<br />
<br />
* В режиме STDIO каждая запись в конфигурации клиента описывает отдельный процесс — несколько подключений к разным экземплярам Svacer задаются простым перечислением.<br />
* В режиме HTTP запускаются независимые контейнеры на разных хост-портах: например, <code>MCP_PORT=8002</code> для одного экземпляра и <code>MCP_PORT=8003</code> для другого. Для каждого контейнера задаётся собственный <code>SVACER_MCP_TOKEN</code>.<br />
<br />
=== Безопасность ===<br />
<br />
* '''STDIO''': сервер не открывает сетевых портов и обменивается данными через стандартные потоки ввода/вывода процесса.<br />
* '''Streamable HTTP''': эндпоинт <code>/mcp</code> требует заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code>. Запросы без токена или с неверным значением получают ответ <code>401</code> и заголовок <code>WWW-Authenticate: Bearer ...</code>. Токен является разделяемым секретом и не заменяет TLS, а дополняет его: при работе за обратным прокси необходимо использовать HTTPS, а сам токен передавать только по защищённому каналу.<br />
* Без <code>SVACER_MCP_TOKEN</code> HTTP-сервер не запускается.<br />
* Учётные данные <code>admin/admin</code> предназначены только для тестового стенда. В рабочем окружении необходимо задать собственные логин и пароль через переменные окружения.<br />
* Файл <code>.env</code> не должен добавляться в систему контроля версий.<br />
<br />
==== Передача токена клиентом ====<br />
Большинство HTTP-клиентов MCP (OpenWebUI и др.) позволяют задать произвольный заголовок <code>Authorization</code> в настройках инструмента — указывается значение <code>Bearer <токен></code>. Для ручной проверки:<br />
<code>curl -H "Authorization: Bearer $SVACER_MCP_TOKEN" \<br />
<nowiki> </nowiki> -H 'Content-Type: application/json' \<br />
<nowiki> </nowiki> -H 'Accept: application/json, text/event-stream' \<br />
<nowiki> </nowiki> -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}' \<br />
<nowiki> </nowiki> <nowiki>http://localhost:8002/mcp</nowiki></code><br />
<br />
== Инструменты ==<br />
Справочник по 8 инструментам Svacer MCP. Типичный порядок вызовов: <code>get_projects</code> → <code>get_snapshots</code> → любой из аналитических инструментов.<br />
{| class="wikitable"<br />
!Инструмент<br />
!Назначение<br />
|-<br />
|<code>get_projects</code><br />
|Список проектов с ветками — точка входа<br />
|-<br />
|<code>get_snapshots</code><br />
|Снимки конкретной ветки, от нового к старому<br />
|-<br />
|<code>get_project_stats</code><br />
|Агрегированные метрики снимка: severity / review / checker<br />
|-<br />
|<code>get_markers</code><br />
|Компактный список маркеров с серверной фильтрацией<br />
|-<br />
|<code>get_warnings</code><br />
|Полные предупреждения с трассами и историей ревью<br />
|-<br />
|<code>get_diff</code><br />
|Сравнение двух снимков: new / missing / modified / matched<br />
|-<br />
|<code>get_advanced_file_preview</code><br />
|Фрагмент исходного кода вокруг строки<br />
|-<br />
|<code>get_project_groups</code><br />
|Группа проектов по имени или UUID<br />
|}<br />
<br />
=== get_projects ===<br />
Список всех проектов с ветками. Точка входа: с этого вызова начинается практически любой сценарий — он возвращает <code>project_id</code> и <code>branch_id</code>, необходимые для последующих запросов.<br />
<br />
'''Параметров нет.'''<br />
<br />
'''Вызов:'''<br />
<code>get_projects()</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"project_id": "91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
"project_name": "bash",<br />
"created": "2021-12-13T13:22:42.122456Z",<br />
"created_by": "admin",<br />
"branches": [<br />
{<br />
"branch_id": "77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
"branch_name": "master",<br />
"created": "2021-12-13T13:22:42.394812Z"<br />
}<br />
]<br />
}<br />
]</code><br />
----<br />
<br />
=== get_snapshots ===<br />
Список снимков для конкретной ветки проекта, от нового к старому.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>name_filter</code><br />
|string<br />
|нет<br />
|Подстрока или regex для фильтра по имени снимка<br />
|}<br />
'''Вызов:'''<br />
<code>get_snapshots(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4"<br />
)</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"snapshot_id": "b42cb563-86f4-4f96-900a-7782163327c9",<br />
"name": "Snapshot 2020-03-25 09:09:41 +0300",<br />
"import_time": "2020-03-25T09:09:41.837296Z",<br />
"commit_hash": null,<br />
"markers_count": 297,<br />
"link": "<nowiki>https://svacer-demo.ispras.ru/</nowiki>..."<br />
}<br />
]</code><br />
----<br />
<br />
=== get_project_stats ===<br />
Агрегированные метрики по снимку: общее количество предупреждений, распределение по критичности, по статусу ревью, по детекторам. Наиболее быстрый способ получить общую картину по проекту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_stats(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9"<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_warnings": 771,<br />
"by_severity": {<br />
"Critical": 1,<br />
"Major": 1,<br />
"Unspecified": 769<br />
},<br />
"by_review_status": {<br />
"Confirmed": 1,<br />
"False Positive": 1,<br />
"Undecided": 767,<br />
"Unclear": 1,<br />
"Won't fix": 1<br />
},<br />
"by_checker": {<br />
"PROC_USE.VULNERABLE": 337,<br />
"UNUSED_FUNC_RES.REWRITE.MINOR": 44,<br />
"UNREACHABLE_CODE": 28,<br />
"DEREF_AFTER_NULL.EX": 27,<br />
"NULL_AFTER_DEREF": 27<br />
}<br />
}</code><br />
----<br />
<br />
=== get_markers ===<br />
Компактный список маркеров с серверной фильтрацией. Основной инструмент для перечисления и обзора: его следует предпочитать <code>get_warnings</code>, когда не требуются развёрнутые поля — трассы и история ревью.<br />
<br />
По умолчанию ответ ограничен 30 маркерами и содержит компактный набор полей. Подробнее об ограничении объёма см. раздел Про объём ответа в сценариях.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора (<code>DEREF_AFTER_NULL</code>, …)<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы маркеров<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю изменений ревью<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии к маркеру<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра из веб-интерфейса Svacer<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров в ответе (по умолчанию <code>30</code>). Значение <code>0</code> снимает ограничение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|Список разрешённых полей маркера верхнего уровня. По умолчанию — компактный набор <code>id, warnClass, file, line, msg, function, review</code>. Значение <code>["*"]</code> возвращает все поля коннектора (<code>id, warnClass, file, line, msg, tool, function, mtid, review</code>, а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены). Допустим и произвольный список — например, <code>["id","warnClass"]</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_markers(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
warnClass=["PROC_USE.VULNERABLE"]<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 341,<br />
"returned_count": 30,<br />
"truncated": true,<br />
"filters_applied": {"warnClass": ["PROC_USE.VULNERABLE"]},<br />
"markers": [<br />
{<br />
"id": "e05bb35b-a95e-4eb2-85ae-3101b788f07d",<br />
"warnClass": "PROC_USE.VULNERABLE.TEMP",<br />
"file": "/.build/lib/sh/tmpfile.c",<br />
"line": 160,<br />
"msg": "Use of vulnerable function 'mktemp' at tmpfile.c:160. ...",<br />
"function": "sh_mktmpname",<br />
"review": null<br />
}<br />
]<br />
}</code><br />
<code>total_count</code> отражает количество маркеров, удовлетворяющих фильтру до применения ограничения; <code>returned_count</code> — количество маркеров, фактически содержащихся в <code>markers</code>. При <code>truncated: true</code> следует либо сузить фильтры (<code>severity</code>, <code>warnClass</code>, <code>file</code>), либо передать <code>limit=0</code> для получения полного списка. Поля <code>tool</code> и <code>mtid</code> возвращаются только при <code>fields=["*"]</code>.<br />
----<br />
<br />
=== get_warnings ===<br />
Полные предупреждения с детальной разметкой. Ответ значительно объёмнее, чем у <code>get_markers</code>, поэтому инструмент следует использовать только тогда, когда нужны поля, отсутствующие в компактной форме: <code>traces</code>, <code>review_history</code>, <code>checker_info</code>, <code>comment_history</code>.<br />
<br />
Лимит по умолчанию — 30; при включённых <code>traces</code>, <code>review_history</code> или <code>comment_history</code> он автоматически снижается до 8, поскольку такие предупреждения существенно объёмнее.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы. Активирует режим расширенных полей (лимит по умолчанию — 8)<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю ревью. Режим расширенных полей<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии. Режим расширенных полей<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество предупреждений в ответе. По умолчанию — <code>30</code>, в режиме расширенных полей — <code>8</code>. Значение <code>0</code> снимает ограничение. Явно заданное <code>limit</code> отменяет автоматическое снижение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_warnings(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
severity=["Critical"],<br />
review_history=True,<br />
traces=True<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 1,<br />
"returned_count": 1,<br />
"truncated": false,<br />
"filters_applied": {"severity": ["Critical"], "traces": true, "review_history": true},<br />
"warnings": [<br />
{<br />
"id": "a3f21c90-1d4e-4b82-9f63-7c8e5d2a1b09",<br />
"warnClass": "DEREF_AFTER_NULL.LOOP",<br />
"file": "/.build/execute_cmd.c",<br />
"line": 3327,<br />
"msg": "Possible null pointer dereference of 'l' after loop exit.",<br />
"function": "select_query",<br />
"review": {"status": "Confirmed", "severity": "Critical"},<br />
"review_history": [{"status": "Confirmed", "changed_by": "admin", "changed_at": "2021-12-13T14:00:00Z"}],<br />
"traces": [{"file": "/.build/execute_cmd.c", "line": 3320, "msg": "Loop starts here; 'l' may exhaust the list."}]<br />
}<br />
]<br />
}</code><br />
----<br />
<br />
=== get_diff ===<br />
Сравнение двух снимков. Категории располагаются под ключом <code>markers</code>: <code>new_markers</code> (появилось в новом снимке), <code>missing_markers</code> (исчезло из нового), <code>modified_markers</code> (тот же идентификатор, изменился контекст), <code>matched_markers</code> (совпало в обоих). Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно UUID снимков.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>base_snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|Старый снимок<br />
|-<br />
|<code>head_snapshot_id</code><br />
|string (UUID)<br />
|нет<br />
|Новый снимок; если не указан, сравнение выполняется с предыдущим по времени<br />
|-<br />
|<code>level</code><br />
|int<br />
|нет<br />
|<code>0</code> — только статистика; <code>1</code> — статистика и идентификаторы маркеров; <code>2</code> — полные маркеры по категориям<br />
|-<br />
|<code>checker_info</code><br />
|bool<br />
|нет<br />
|Метаданные детекторов для маркеров (только при <code>level >= 2</code>)<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров '''на каждую категорию''' при <code>level >= 2</code>. По умолчанию — <code>20</code>, значение <code>0</code> снимает ограничение. Параметр игнорируется при <code>level < 2</code><br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code>/<code>get_warnings</code>. Применяется к маркерам внутри категорий при <code>level >= 2</code><br />
|}<br />
'''Вызов (<code>level=0</code>):'''<br />
<code>get_diff(<br />
base_snapshot_id="72b3df7b-c15a-4e3d-8f92-a041dc6e5b87",<br />
head_snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
level=0<br />
)</code><br />
'''Ответ (<code>level=0</code>):'''<br />
<code>{<br />
"stats": {<br />
"context1": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-20 ..."},<br />
"context2": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-25 ..."},<br />
"scope": ["NEW", "MISSING", "MATCHED", "MODIFIED"],<br />
"new": 9,<br />
"missing": 12,<br />
"modified": 98,<br />
"matched": 187<br />
}<br />
}</code><br />
'''Ответ (<code>level=2</code>)''' — каждая категория внутри <code>markers</code> оформляется и ограничивается независимо:<br />
<code>{<br />
"stats": {"new": 50, "missing": 5, "modified": 0, "matched": 187},<br />
"markers": {<br />
"new_markers": {<br />
"total_count": 50,<br />
"returned_count": 20,<br />
"truncated": true,<br />
"markers": [<br />
{"id": "a3f21c90-...", "warnClass": "DEREF_AFTER_NULL.LOOP", "file": "...", "line": 3327, "msg": "...", "function": "select_query", "review": null}<br />
]<br />
},<br />
"missing_markers": {"total_count": 5, "returned_count": 5, "truncated": false, "markers": [...]},<br />
"modified_markers": {"total_count": 0, "returned_count": 0, "truncated": false, "markers": []},<br />
"matched_markers": {"total_count": 187, "returned_count": 20, "truncated": true, "markers": [...]}<br />
}<br />
}</code><br />
Если требуется полное содержимое категории, следует увеличить <code>limit</code> либо запросить нужные идентификаторы отдельным вызовом <code>get_markers</code>. Маркеры внутри категорий проходят ту же компактную обработку, что и в <code>get_warnings</code>: значение <code>fields=["*"]</code> возвращает фиксированный набор полей коннектора, а не произвольные «сырые» поля API.<br />
----<br />
<br />
=== get_advanced_file_preview ===<br />
Фрагмент исходного кода из снимка вокруг указанной строки. Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно идентификатора снимка и пути к файлу.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>file_path</code><br />
|string<br />
|да<br />
|Путь к файлу в том виде, в котором его возвращают <code>get_markers</code> и <code>get_warnings</code><br />
|-<br />
|<code>line</code><br />
|int<br />
|нет<br />
|Центральная строка, нумерация с 1 (по умолчанию <code>1</code>)<br />
|-<br />
|<code>before</code><br />
|int<br />
|нет<br />
|Количество строк до центральной (по умолчанию <code>0</code>)<br />
|-<br />
|<code>after</code><br />
|int<br />
|нет<br />
|Количество строк после центральной (по умолчанию <code>99999</code> — до конца файла)<br />
|}<br />
'''Вызов:'''<br />
<code>get_advanced_file_preview(<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
file_path="/.build/execute_cmd.c",<br />
line=3327,<br />
before=10,<br />
after=10<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"line": 3327,<br />
"content": " for (l = list; l && --reply; l = l->next)\n\t;\n return (l->word->word);\n",<br />
"total_lines": 6082<br />
}</code><br />
----<br />
<br />
=== get_project_groups ===<br />
Получить группу проектов по имени или UUID. Группы объединяют проекты в логические блоки — например, по команде или продукту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>name_or_id</code><br />
|string<br />
|да<br />
|Имя группы или её UUID<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_groups(name_or_id="Linux Tools")</code><br />
'''Ответ:'''<br />
<code>{<br />
"project_group_id": "c4f8a2d1-3b7e-4f90-82ac-1d5e8f2b6c04",<br />
"project_group_name": "Linux Tools",<br />
"projects": [<br />
{"id": "91630e84-db2f-4d8c-8716-68b7fdf17a66", "name": "bash"},<br />
{"id": "d3a17f52-...", "name": "coreutils"}<br />
]<br />
}</code><br />
<code>projects[].id</code> — это <code>project_id</code>, который далее передаётся в <code>get_snapshots</code>. Группы и проекты — разные сущности; идентификатор группы и идентификатор проекта не взаимозаменяемы.<br />
<br />
== Примеры сценариев ==<br />
Приведённые ниже запросы выполнены на демонстрационном стенде <code>svacer-demo.ispras.ru</code> с использованием OpenWebUI и модели <code>qwen3-coder:30b</code>. В любом другом MCP-клиенте с моделью достаточной мощности порядок вызовов будет аналогичным.<br />
<br />
=== Про объём ответа ===<br />
<code>get_markers</code>, <code>get_warnings</code> и <code>get_diff(level=2)</code> по умолчанию ограничивают объём ответа, чтобы не перегружать контекст модели:<br />
<br />
* <code>get_markers</code> и <code>get_warnings</code> — 30 маркеров по умолчанию. Если у <code>get_warnings</code> включены <code>traces</code>, <code>review_history</code> или <code>comment_history</code>, лимит снижается до 8, поскольку такие маркеры значительно объёмнее.<br />
* <code>get_diff(level=2)</code> — 20 маркеров на каждую категорию внутри <code>markers</code> (<code>new_markers</code>/<code>missing_markers</code>/<code>modified_markers</code>/<code>matched_markers</code>).<br />
<br />
В ответе присутствуют поля <code>total_count</code>, <code>returned_count</code>, <code>truncated</code>. При <code>truncated: true</code> есть два варианта действий: сузить фильтр (<code>severity</code>, <code>warnClass</code>, <code>file</code>) либо явно увеличить <code>limit</code> (значение <code>limit=0</code> полностью снимает ограничение).<br />
<br />
Поле <code>fields</code> определяет, какие ключи маркера возвращаются. По умолчанию применяется компактный набор <code>id, warnClass, file, line, msg, function, review</code> (а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены логическими флагами и пришли с сервера). Для полного маркера со всеми служебными ключами — <code>fields=["*"]</code>. Для произвольной выборки — список полей верхнего уровня, например <code>fields=["id","warnClass"]</code>. Поле <code>review</code> — объект <code>{status, severity, action}</code>; вложенные ключи в <code>fields</code> не поддерживаются, поэтому объект <code>review</code> запрашивается целиком.<br />
<br />
=== Перечислить все проекты ===<br />
<blockquote>Какие проекты есть в Svacer?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
<br />
'''Ответ модели:'''<blockquote>В Svacer доступно 6 проектов: bash, openssl, paho.mqtt.c, coturn, zstd, darpa. У каждого — одна ветка <code>master</code>.</blockquote><br />
<br />
=== Посмотреть снимки проекта ===<br />
<blockquote>Какие снимки есть у paho.mqtt.c? Самый свежий когда?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code> — найти <code>project_id</code> и <code>branch_id</code><br />
# <code>get_snapshots(project_id=..., branch_id=...)</code><br />
<br />
'''Ответ модели:'''<blockquote>У paho.mqtt.c 3 снимка. Самый свежий — «Snapshot 2020-03-25 09:09:41 +0300» (297 маркеров). Предыдущий — 20 марта (306 маркеров).</blockquote>Поле <code>commit_hash</code> может принимать значение <code>null</code>, если проект не сохраняет хэш коммита в <code>custom_properties</code>. Имена снимков произвольны: одни проекты записывают в имя дату, другие — коммит, третьи — свободный текст.<br />
<br />
=== Сводка по проекту ===<br />
<blockquote>Что в bash в последнем снимке? Сколько всего предупреждений, есть ли критические, какие топ-детекторы?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots(project_id, branch_id)</code> — взять последний снимок<br />
# <code>get_project_stats(project_id, branch_id, snapshot_id)</code><br />
<br />
'''Ответ модели:'''<blockquote>В последнем снимке bash содержится 771 предупреждение:<br />
<br />
* Критических: 1 (Confirmed)<br />
* Major: 1 (Won't fix)<br />
* Остальные: 769 (Unspecified — не ревьюились)<br />
<br />
Топ-детекторы по количеству:<br />
<br />
# <code>PROC_USE.VULNERABLE</code> — 337<br />
# <code>UNUSED_FUNC_RES.REWRITE.MINOR</code> — 44<br />
# <code>UNREACHABLE_CODE</code> — 28<br />
# <code>DEREF_AFTER_NULL.EX</code> — 27<br />
# <code>NULL_AFTER_DEREF</code> — 27<br />
</blockquote><code>Unspecified</code> в <code>by_severity</code> — маркеры без ручного ревью, а не «низкий приоритет». Поле <code>by_checker</code> не сортируется, на большом снимке оно может содержать более 100 ключей — чтобы получить именно топ-N, следует явно сформулировать запрос: «топ-5 детекторов».<br />
<br />
=== Тренд по нескольким снимкам ===<br />
<blockquote>Как у openssl менялось число предупреждений за последние пять снимков? Покажи таблицей.</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — взять список<br />
# <code>get_project_stats()</code> × 5 — по каждому из последних пяти снимков<br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
{| class="wikitable"<br />
|+<br />
!Снимок<br />
!Дата<br />
!Всего<br />
|-<br />
|2020-04-30 05:49<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:29<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:08<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:48<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:22<br />
|30.04.2020<br />
|1252<br />
|}<br />
</blockquote><br />
На демонстрационном стенде указанные пять снимков openssl импортированы с интервалом в 20 минут одного дня и полностью идентичны — поэтому динамика отсутствует. На реальном проекте с историей релизов значения будут изменяться.<br />
<br />
=== Найти срабатывания конкретного детектора ===<br />
<blockquote>Где в bash срабатывает PROC_USE.VULNERABLE? Покажи список — файл, строка, что именно ругается. Достаточно первых десяти.</blockquote>'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code><br />
# <code>get_markers(warnClass=["PROC_USE.VULNERABLE"])</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
# <code>/.build/lib/sh/tmpfile.c:160</code> — <code>mktemp()</code>, race condition. Рекомендуется <code>mkstemp()</code>.<br />
# <code>/.build/lib/readline/shell.c:151</code> — <code>getenv()</code>, значение может быть подменено.<br />
# <code>/.build/shell.c:415</code> — <code>getenv()</code> в <code>main()</code>.<br />
# <code>/.build/lib/readline/complete.c:1516</code> — <code>getenv()</code>.<br />
# <code>/.build/lib/sh/eaccess.c:115</code> — <code>strcat()</code>, рекомендуется <code>strncat()</code>. …<br />
</blockquote><br />
Фильтр <code>warnClass=["PROC_USE.VULNERABLE"]</code> охватывает все подклассы: <code>PROC_USE.VULNERABLE.TEMP</code>, <code>.GETENV</code>, <code>.STRCAT</code> и т. д. — всего 341 маркер. Несколько значений в одном параметре трактуются как логическое «ИЛИ»: <code>severity=["Critical","Major"]</code> возвращает маркеры обеих категорий.<br />
<br />
В ответе будет <code>total_count: 341, returned_count: 30, truncated: true</code> — это ожидаемое поведение. Модель видит общий объём по <code>total_count</code> и при необходимости сужает запрос или вызывает <code>get_markers(..., limit=0)</code>, чтобы получить полный список.<br />
<br />
=== Сравнить два снимка ===<br />
<blockquote>Возьми два последних снимка paho.mqtt.c — что между ними изменилось? Сколько новых предупреждений, сколько починили?</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — два последних<br />
# <code>get_diff(base_snapshot_id="72b3df7b-...", head_snapshot_id="b42cb563-...", level=0)</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote>Между двумя последними снимками paho.mqtt.c:<br />
<br />
* Новых: 12<br />
* Удалённых: 13<br />
* Изменённых: 99<br />
* Совпадающих: 185<br />
<br />
Удалено несколько больше, чем добавлено — общая картина практически не изменилась.</blockquote><br />
<br />
Категория <code>modified</code> — маркер, присутствующий в обоих снимках, у которого изменилось окружение (номер строки, контекст функции). Это не новая ошибка. На больших проектах рекомендуется начинать с <code>level=0</code> для получения статистики, при необходимости использовать <code>level=1</code> (только идентификаторы маркеров) и затем точечно вызывать <code>get_markers</code> с нужными фильтрами.<br />
<br />
<code>level=2</code> возвращает полные маркеры по категориям, причём каждая категория по умолчанию ограничена 20 маркерами. Категории располагаются внутри <code>markers</code>: <code>new_markers</code>, <code>missing_markers</code>, <code>modified_markers</code>, <code>matched_markers</code>. Структура ответа в JSON: <code><nowiki>{"markers": {"new_markers": {"total_count": N, "returned_count": ..., "truncated": ..., "markers": [...]}, ...}}</nowiki></code>. Если требуется полное содержимое категории, следует увеличить <code>limit</code> или выполнить отдельный вызов <code>get_markers</code> по нужным идентификаторам.<br />
<br />
=== Разобрать конкретное предупреждение ===<br />
<blockquote>В bash есть один подтверждённый критикал — что-то про разыменование указателя. Покажи код вокруг этого места и объясни в чём проблема.</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code> → <code>get_snapshots()</code> — найти снимок bash<br />
# <code>get_markers(severity=["Critical"], review=["Confirmed"])</code><br />
# <code>get_advanced_file_preview(file_path="/.build/execute_cmd.c", line=3327, before=10, after=10)</code><br />
<br />
'''Ответ модели:<blockquote>Маркер <code>DEREF_AFTER_NULL.LOOP</code> в функции <code>select_query()</code>, строка 3327:<br />
for (l = list; l && --reply; l = l->next)<br />
;<br />
return (l->word->word); /* l может быть NULL после выхода из цикла */<br />
<br />
Если список заканчивается раньше, чем <code>reply</code> обнуляется, <code>l</code> станет <code>NULL</code> на последнем <code>l->next</code>, и следующий <code>l->word->word</code> — разыменование нулевого указателя.</blockquote><code>file_path</code> должен точно совпадать со значением, возвращённым маркером, включая ведущий префикс <code>/.build/...</code>. Это путь внутри сборочной директории Svacer, а не путь в исходном репозитории; соответствие в репозитории определяется по имени файла.<br />
<br />
Для одиночной разметки удобно сразу запрашивать полный маркер с трассами: <code>get_markers(..., severity=["Critical"], review=["Confirmed"], traces=True, checker_info=True)</code>. Флаги <code>traces</code> и <code>checker_info</code> указывают серверу включить соответствующие поля в ответ; в выдаче они сохраняются и при значении <code>fields</code> по умолчанию. Значение <code>fields=["*"]</code> требуется лишь в том случае, когда дополнительно нужны <code>tool</code> и <code>mtid</code> — служебные ключи, исключённые из компактного набора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_MCP&diff=3503Help:13-alpha MCP2026-05-21T09:57:34Z<p>Mitrofanov: /* Тренд по нескольким снимкам */</p>
<hr />
<div>== Архитектура ==<br />
[https://modelcontextprotocol.io/docs/getting-started/intro MCP] — открытый стандарт, через который LLM-клиенты (Claude Desktop, Cursor, VS Code, OpenWebUI и др.) вызывают внешние инструменты. <br />
Svacer MCP соединяет одно с другим: 8 инструментов поверх публичного REST API Svacer, которые LLM выбирает и вызывает в ответ на обычный текстовый запрос. Вместо ручной последовательности «открыть UI, найти проект, выбрать снимок, применить фильтр» достаточно сформулировать вопрос в чате, например, «сколько критических предупреждений в последнем снимке bash?», и получить ответ. Необходимые вызовы инструментов модель выполняет самостоятельно.<br />
<br />
[[File:Архитектура MCP.png|thumb|none|x800px|alt=architectureMCP|Архитектура MCP-сервер]]<br />
<br />
Поток запроса: LLM-клиент отправляет MCP-вызов через STDIO или Streamable HTTP → <code>server.py</code> передаёт его в выбранный инструмент из <code>tools/</code> → инструмент проверяет параметры и обращается к <code>api_client.py</code> → клиент получает JWT от <code>auth.py</code> (модуль автоматически обновляет токен по истечении срока действия или при ответе 401) → запрос отправляется в Svacer REST API.<br />
<br />
== Установка ==<br />
Установка Svacer MCP, подключение клиентов и конфигурация.<br />
<br />
=== Требования ===<br />
<br />
* Python 3.10+<br />
* Доступ к Svacer-серверу: URL + логин/пароль<br />
<br />
=== Режим STDIO ===<br />
Подходит для настольных клиентов: Claude Desktop, Claude Code, Cursor, VS Code.<br />
<code>git clone <nowiki>https://gitlab.ispras.ru/svacerai/mcp.git</nowiki> && cd mcp<br />
<br />
python3 -m venv .venv<br />
.venv/bin/pip install -e .<br />
<br />
cp .env.example .env<br />
# Отредактировать .env — указать URL и учётные данные Svacer<br />
<br />
# Проверить запуск (сервер ожидает данные на stdin; для выхода — Ctrl+C)<br />
.venv/bin/svacer-mcp</code><br />
После <code>pip install -e .</code> в окружении становится доступна команда <code>svacer-mcp</code> — её указывают в конфигурации клиентов ниже.<br />
<br />
=== Режим HTTP (Docker) ===<br />
Подходит для веб-клиентов (OpenWebUI) и удалённого доступа.<br />
<br />
'''Требования:''' Docker, Docker Compose.<br />
<code>cp .env.example .env<br />
<br />
# В .env обязательно задать SVACER_MCP_TOKEN — без него сервер не запускается<br />
echo "SVACER_MCP_TOKEN=$(openssl rand -hex 32)" >> .env<br />
<br />
docker compose up -d<br />
<br />
# MCP endpoint: <nowiki>http://localhost:8002/mcp</nowiki><br />
# Клиенты передают заголовок: Authorization: Bearer <SVACER_MCP_TOKEN></code><br />
Внешний порт хоста задаётся переменной <code>MCP_PORT</code> (по умолчанию <code>8002</code>), внутри контейнера сервер всегда слушает порт <code>8000</code>.<br />
<br />
=== Подключение клиентов ===<br />
<br />
==== Claude Desktop ====<br />
Файл конфигурации: <code>~/.config/Claude/claude_desktop_config.json</code> (Linux) или <code>%APPDATA%\Claude\claude_desktop_config.json</code> (Windows).<br />
<br />
Укажите '''абсолютный путь''' к <code>svacer-mcp</code> из вашего venv (<code>which svacer-mcp</code> в активированном venv или <code>/path/to/mcp/.venv/bin/svacer-mcp</code>).<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Claude Code ====<br />
<code>claude mcp add svacer \<br />
-e SVACER_URL=<nowiki>https://your-svacer.example.com</nowiki> \<br />
-e SVACER_LOGIN=your-login \<br />
-e SVACER_PASSWORD=your-password \<br />
-- /path/to/mcp/.venv/bin/svacer-mcp</code><br />
<br />
==== VS Code ====<br />
Файл <code>.vscode/mcp.json</code> в корне рабочей директории:<br />
<code>{<br />
"servers": {<br />
"svacer": {<br />
"type": "stdio",<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Cursor ====<br />
Файл <code>.cursor/mcp.json</code> в корне проекта или глобально:<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== OpenWebUI ====<br />
<br />
# Развернуть через Docker (см. «Режим HTTP» выше).<br />
# Открыть '''Settings → Tools''' (или '''Admin Panel → Settings → Tools''').<br />
# Добавить сервер:<br />
#* <code><nowiki>http://localhost:8002/mcp</nowiki></code> — если OpenWebUI работает на хосте, снаружи Docker.<br />
#* <code><nowiki>http://svacer-mcp:8000/mcp</nowiki></code> — если OpenWebUI развёрнут в той же compose-сети, что и <code>svacer-mcp</code> (имя берётся из <code>docker-compose.yml</code> → service name, порт 8000 — внутренний порт контейнера).<br />
# Тип подключения: '''MCP (Streamable HTTP)'''.<br />
# В настройках инструмента указать заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code> (значение — то же, что в <code>.env</code> сервера).<br />
# Сохранить — инструменты появятся в чате.<br />
<br />
=== Конфигурация ===<br />
{| class="wikitable"<br />
!Переменная<br />
!По умолчанию<br />
!Описание<br />
|-<br />
|<code>SVACER_URL</code><br />
|<code><nowiki>https://svacer-demo.ispras.ru</nowiki></code><br />
|URL Svacer-сервера<br />
|-<br />
|<code>SVACER_LOGIN</code><br />
|<code>admin</code><br />
|Логин<br />
|-<br />
|<code>SVACER_PASSWORD</code><br />
|<code>admin</code><br />
|Пароль<br />
|-<br />
|<code>SVACER_TIMEOUT</code><br />
|<code>30</code><br />
|Тайм-аут HTTP-запросов к Svacer, секунды<br />
|-<br />
|<code>SVACER_TRANSPORT</code><br />
|<code>stdio</code><br />
|Режим транспорта: <code>stdio</code> или <code>http</code><br />
|-<br />
|<code>SVACER_HTTP_PORT</code><br />
|<code>8000</code><br />
|TCP-порт сервера в режиме HTTP (внутри контейнера)<br />
|-<br />
|<code>SVACER_MCP_TOKEN</code><br />
|''(не задано)''<br />
|Bearer-токен для клиентов <code>/mcp</code>. Обязателен при <code>SVACER_TRANSPORT=http</code>, в режиме STDIO игнорируется. Генерация: <code>openssl rand -hex 32</code><br />
|-<br />
|<code>SVACER_MCP_RESOURCE_URL</code><br />
|<code><nowiki>http://localhost</nowiki>:<HTTP_PORT></code><br />
|Публичный URL MCP-сервера для заголовка <code>WWW-Authenticate</code> (<nowiki>RFC 9728</nowiki>). Задаётся при работе за обратным прокси<br />
|-<br />
|<code>SVACER_TOOLS</code><br />
|''(не задано)''<br />
|Список инструментов через запятую. Если не задано, регистрируются все 8<br />
|-<br />
|<code>MCP_PORT</code><br />
|<code>8002</code><br />
|Внешний порт хоста при запуске через <code>docker compose</code> (отображается на внутренний <code>SVACER_HTTP_PORT</code>)<br />
|}<br />
Переменные читаются из <code>.env</code> или из окружения. Для STDIO-клиентов их можно указать в секции <code>env</code> конфигурации клиента.<br />
<br />
==== Ограничение набора инструментов ====<br />
Чтобы запустить сервер с подмножеством инструментов (например, для уменьшения объёма контекста у модели или разграничения доступа), задайте <code>SVACER_TOOLS</code>:<br />
<code>SVACER_TOOLS=get_projects,get_snapshots,get_markers</code><br />
Допустимые имена: <code>get_projects</code>, <code>get_snapshots</code>, <code>get_warnings</code>, <code>get_markers</code>, <code>get_project_stats</code>, <code>get_project_groups</code>, <code>get_advanced_file_preview</code>, <code>get_diff</code>. Неизвестное имя в списке приводит к ошибке при запуске. Если переменная пустая или не задана, регистрируются все 8 инструментов.<br />
<br />
==== Несколько экземпляров сервера ====<br />
Параллельный запуск нескольких MCP-серверов поддерживается без ограничений.<br />
<br />
* В режиме STDIO каждая запись в конфигурации клиента описывает отдельный процесс — несколько подключений к разным экземплярам Svacer задаются простым перечислением.<br />
* В режиме HTTP запускаются независимые контейнеры на разных хост-портах: например, <code>MCP_PORT=8002</code> для одного экземпляра и <code>MCP_PORT=8003</code> для другого. Для каждого контейнера задаётся собственный <code>SVACER_MCP_TOKEN</code>.<br />
<br />
=== Безопасность ===<br />
<br />
* '''STDIO''': сервер не открывает сетевых портов и обменивается данными через стандартные потоки ввода/вывода процесса.<br />
* '''Streamable HTTP''': эндпоинт <code>/mcp</code> требует заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code>. Запросы без токена или с неверным значением получают ответ <code>401</code> и заголовок <code>WWW-Authenticate: Bearer ...</code>. Токен является разделяемым секретом и не заменяет TLS, а дополняет его: при работе за обратным прокси необходимо использовать HTTPS, а сам токен передавать только по защищённому каналу.<br />
* Без <code>SVACER_MCP_TOKEN</code> HTTP-сервер не запускается.<br />
* Учётные данные <code>admin/admin</code> предназначены только для тестового стенда. В рабочем окружении необходимо задать собственные логин и пароль через переменные окружения.<br />
* Файл <code>.env</code> не должен добавляться в систему контроля версий.<br />
<br />
==== Передача токена клиентом ====<br />
Большинство HTTP-клиентов MCP (OpenWebUI и др.) позволяют задать произвольный заголовок <code>Authorization</code> в настройках инструмента — указывается значение <code>Bearer <токен></code>. Для ручной проверки:<br />
<code>curl -H "Authorization: Bearer $SVACER_MCP_TOKEN" \<br />
<nowiki> </nowiki> -H 'Content-Type: application/json' \<br />
<nowiki> </nowiki> -H 'Accept: application/json, text/event-stream' \<br />
<nowiki> </nowiki> -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}' \<br />
<nowiki> </nowiki> <nowiki>http://localhost:8002/mcp</nowiki></code><br />
<br />
== Инструменты ==<br />
Справочник по 8 инструментам Svacer MCP. Типичный порядок вызовов: <code>get_projects</code> → <code>get_snapshots</code> → любой из аналитических инструментов.<br />
{| class="wikitable"<br />
!Инструмент<br />
!Назначение<br />
|-<br />
|<code>get_projects</code><br />
|Список проектов с ветками — точка входа<br />
|-<br />
|<code>get_snapshots</code><br />
|Снимки конкретной ветки, от нового к старому<br />
|-<br />
|<code>get_project_stats</code><br />
|Агрегированные метрики снимка: severity / review / checker<br />
|-<br />
|<code>get_markers</code><br />
|Компактный список маркеров с серверной фильтрацией<br />
|-<br />
|<code>get_warnings</code><br />
|Полные предупреждения с трассами и историей ревью<br />
|-<br />
|<code>get_diff</code><br />
|Сравнение двух снимков: new / missing / modified / matched<br />
|-<br />
|<code>get_advanced_file_preview</code><br />
|Фрагмент исходного кода вокруг строки<br />
|-<br />
|<code>get_project_groups</code><br />
|Группа проектов по имени или UUID<br />
|}<br />
<br />
=== get_projects ===<br />
Список всех проектов с ветками. Точка входа: с этого вызова начинается практически любой сценарий — он возвращает <code>project_id</code> и <code>branch_id</code>, необходимые для последующих запросов.<br />
<br />
'''Параметров нет.'''<br />
<br />
'''Вызов:'''<br />
<code>get_projects()</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"project_id": "91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
"project_name": "bash",<br />
"created": "2021-12-13T13:22:42.122456Z",<br />
"created_by": "admin",<br />
"branches": [<br />
{<br />
"branch_id": "77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
"branch_name": "master",<br />
"created": "2021-12-13T13:22:42.394812Z"<br />
}<br />
]<br />
}<br />
]</code><br />
----<br />
<br />
=== get_snapshots ===<br />
Список снимков для конкретной ветки проекта, от нового к старому.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>name_filter</code><br />
|string<br />
|нет<br />
|Подстрока или regex для фильтра по имени снимка<br />
|}<br />
'''Вызов:'''<br />
<code>get_snapshots(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4"<br />
)</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"snapshot_id": "b42cb563-86f4-4f96-900a-7782163327c9",<br />
"name": "Snapshot 2020-03-25 09:09:41 +0300",<br />
"import_time": "2020-03-25T09:09:41.837296Z",<br />
"commit_hash": null,<br />
"markers_count": 297,<br />
"link": "<nowiki>https://svacer-demo.ispras.ru/</nowiki>..."<br />
}<br />
]</code><br />
----<br />
<br />
=== get_project_stats ===<br />
Агрегированные метрики по снимку: общее количество предупреждений, распределение по критичности, по статусу ревью, по детекторам. Наиболее быстрый способ получить общую картину по проекту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_stats(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9"<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_warnings": 771,<br />
"by_severity": {<br />
"Critical": 1,<br />
"Major": 1,<br />
"Unspecified": 769<br />
},<br />
"by_review_status": {<br />
"Confirmed": 1,<br />
"False Positive": 1,<br />
"Undecided": 767,<br />
"Unclear": 1,<br />
"Won't fix": 1<br />
},<br />
"by_checker": {<br />
"PROC_USE.VULNERABLE": 337,<br />
"UNUSED_FUNC_RES.REWRITE.MINOR": 44,<br />
"UNREACHABLE_CODE": 28,<br />
"DEREF_AFTER_NULL.EX": 27,<br />
"NULL_AFTER_DEREF": 27<br />
}<br />
}</code><br />
----<br />
<br />
=== get_markers ===<br />
Компактный список маркеров с серверной фильтрацией. Основной инструмент для перечисления и обзора: его следует предпочитать <code>get_warnings</code>, когда не требуются развёрнутые поля — трассы и история ревью.<br />
<br />
По умолчанию ответ ограничен 30 маркерами и содержит компактный набор полей. Подробнее об ограничении объёма см. раздел Про объём ответа в сценариях.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора (<code>DEREF_AFTER_NULL</code>, …)<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы маркеров<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю изменений ревью<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии к маркеру<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра из веб-интерфейса Svacer<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров в ответе (по умолчанию <code>30</code>). Значение <code>0</code> снимает ограничение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|Список разрешённых полей маркера верхнего уровня. По умолчанию — компактный набор <code>id, warnClass, file, line, msg, function, review</code>. Значение <code>["*"]</code> возвращает все поля коннектора (<code>id, warnClass, file, line, msg, tool, function, mtid, review</code>, а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены). Допустим и произвольный список — например, <code>["id","warnClass"]</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_markers(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
warnClass=["PROC_USE.VULNERABLE"]<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 341,<br />
"returned_count": 30,<br />
"truncated": true,<br />
"filters_applied": {"warnClass": ["PROC_USE.VULNERABLE"]},<br />
"markers": [<br />
{<br />
"id": "e05bb35b-a95e-4eb2-85ae-3101b788f07d",<br />
"warnClass": "PROC_USE.VULNERABLE.TEMP",<br />
"file": "/.build/lib/sh/tmpfile.c",<br />
"line": 160,<br />
"msg": "Use of vulnerable function 'mktemp' at tmpfile.c:160. ...",<br />
"function": "sh_mktmpname",<br />
"review": null<br />
}<br />
]<br />
}</code><br />
<code>total_count</code> отражает количество маркеров, удовлетворяющих фильтру до применения ограничения; <code>returned_count</code> — количество маркеров, фактически содержащихся в <code>markers</code>. При <code>truncated: true</code> следует либо сузить фильтры (<code>severity</code>, <code>warnClass</code>, <code>file</code>), либо передать <code>limit=0</code> для получения полного списка. Поля <code>tool</code> и <code>mtid</code> возвращаются только при <code>fields=["*"]</code>.<br />
----<br />
<br />
=== get_warnings ===<br />
Полные предупреждения с детальной разметкой. Ответ значительно объёмнее, чем у <code>get_markers</code>, поэтому инструмент следует использовать только тогда, когда нужны поля, отсутствующие в компактной форме: <code>traces</code>, <code>review_history</code>, <code>checker_info</code>, <code>comment_history</code>.<br />
<br />
Лимит по умолчанию — 30; при включённых <code>traces</code>, <code>review_history</code> или <code>comment_history</code> он автоматически снижается до 8, поскольку такие предупреждения существенно объёмнее.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы. Активирует режим расширенных полей (лимит по умолчанию — 8)<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю ревью. Режим расширенных полей<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии. Режим расширенных полей<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество предупреждений в ответе. По умолчанию — <code>30</code>, в режиме расширенных полей — <code>8</code>. Значение <code>0</code> снимает ограничение. Явно заданное <code>limit</code> отменяет автоматическое снижение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_warnings(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
severity=["Critical"],<br />
review_history=True,<br />
traces=True<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 1,<br />
"returned_count": 1,<br />
"truncated": false,<br />
"filters_applied": {"severity": ["Critical"], "traces": true, "review_history": true},<br />
"warnings": [<br />
{<br />
"id": "a3f21c90-1d4e-4b82-9f63-7c8e5d2a1b09",<br />
"warnClass": "DEREF_AFTER_NULL.LOOP",<br />
"file": "/.build/execute_cmd.c",<br />
"line": 3327,<br />
"msg": "Possible null pointer dereference of 'l' after loop exit.",<br />
"function": "select_query",<br />
"review": {"status": "Confirmed", "severity": "Critical"},<br />
"review_history": [{"status": "Confirmed", "changed_by": "admin", "changed_at": "2021-12-13T14:00:00Z"}],<br />
"traces": [{"file": "/.build/execute_cmd.c", "line": 3320, "msg": "Loop starts here; 'l' may exhaust the list."}]<br />
}<br />
]<br />
}</code><br />
----<br />
<br />
=== get_diff ===<br />
Сравнение двух снимков. Категории располагаются под ключом <code>markers</code>: <code>new_markers</code> (появилось в новом снимке), <code>missing_markers</code> (исчезло из нового), <code>modified_markers</code> (тот же идентификатор, изменился контекст), <code>matched_markers</code> (совпало в обоих). Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно UUID снимков.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>base_snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|Старый снимок<br />
|-<br />
|<code>head_snapshot_id</code><br />
|string (UUID)<br />
|нет<br />
|Новый снимок; если не указан, сравнение выполняется с предыдущим по времени<br />
|-<br />
|<code>level</code><br />
|int<br />
|нет<br />
|<code>0</code> — только статистика; <code>1</code> — статистика и идентификаторы маркеров; <code>2</code> — полные маркеры по категориям<br />
|-<br />
|<code>checker_info</code><br />
|bool<br />
|нет<br />
|Метаданные детекторов для маркеров (только при <code>level >= 2</code>)<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров '''на каждую категорию''' при <code>level >= 2</code>. По умолчанию — <code>20</code>, значение <code>0</code> снимает ограничение. Параметр игнорируется при <code>level < 2</code><br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code>/<code>get_warnings</code>. Применяется к маркерам внутри категорий при <code>level >= 2</code><br />
|}<br />
'''Вызов (<code>level=0</code>):'''<br />
<code>get_diff(<br />
base_snapshot_id="72b3df7b-c15a-4e3d-8f92-a041dc6e5b87",<br />
head_snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
level=0<br />
)</code><br />
'''Ответ (<code>level=0</code>):'''<br />
<code>{<br />
"stats": {<br />
"context1": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-20 ..."},<br />
"context2": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-25 ..."},<br />
"scope": ["NEW", "MISSING", "MATCHED", "MODIFIED"],<br />
"new": 9,<br />
"missing": 12,<br />
"modified": 98,<br />
"matched": 187<br />
}<br />
}</code><br />
'''Ответ (<code>level=2</code>)''' — каждая категория внутри <code>markers</code> оформляется и ограничивается независимо:<br />
<code>{<br />
"stats": {"new": 50, "missing": 5, "modified": 0, "matched": 187},<br />
"markers": {<br />
"new_markers": {<br />
"total_count": 50,<br />
"returned_count": 20,<br />
"truncated": true,<br />
"markers": [<br />
{"id": "a3f21c90-...", "warnClass": "DEREF_AFTER_NULL.LOOP", "file": "...", "line": 3327, "msg": "...", "function": "select_query", "review": null}<br />
]<br />
},<br />
"missing_markers": {"total_count": 5, "returned_count": 5, "truncated": false, "markers": [...]},<br />
"modified_markers": {"total_count": 0, "returned_count": 0, "truncated": false, "markers": []},<br />
"matched_markers": {"total_count": 187, "returned_count": 20, "truncated": true, "markers": [...]}<br />
}<br />
}</code><br />
Если требуется полное содержимое категории, следует увеличить <code>limit</code> либо запросить нужные идентификаторы отдельным вызовом <code>get_markers</code>. Маркеры внутри категорий проходят ту же компактную обработку, что и в <code>get_warnings</code>: значение <code>fields=["*"]</code> возвращает фиксированный набор полей коннектора, а не произвольные «сырые» поля API.<br />
----<br />
<br />
=== get_advanced_file_preview ===<br />
Фрагмент исходного кода из снимка вокруг указанной строки. Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно идентификатора снимка и пути к файлу.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>file_path</code><br />
|string<br />
|да<br />
|Путь к файлу в том виде, в котором его возвращают <code>get_markers</code> и <code>get_warnings</code><br />
|-<br />
|<code>line</code><br />
|int<br />
|нет<br />
|Центральная строка, нумерация с 1 (по умолчанию <code>1</code>)<br />
|-<br />
|<code>before</code><br />
|int<br />
|нет<br />
|Количество строк до центральной (по умолчанию <code>0</code>)<br />
|-<br />
|<code>after</code><br />
|int<br />
|нет<br />
|Количество строк после центральной (по умолчанию <code>99999</code> — до конца файла)<br />
|}<br />
'''Вызов:'''<br />
<code>get_advanced_file_preview(<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
file_path="/.build/execute_cmd.c",<br />
line=3327,<br />
before=10,<br />
after=10<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"line": 3327,<br />
"content": " for (l = list; l && --reply; l = l->next)\n\t;\n return (l->word->word);\n",<br />
"total_lines": 6082<br />
}</code><br />
----<br />
<br />
=== get_project_groups ===<br />
Получить группу проектов по имени или UUID. Группы объединяют проекты в логические блоки — например, по команде или продукту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>name_or_id</code><br />
|string<br />
|да<br />
|Имя группы или её UUID<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_groups(name_or_id="Linux Tools")</code><br />
'''Ответ:'''<br />
<code>{<br />
"project_group_id": "c4f8a2d1-3b7e-4f90-82ac-1d5e8f2b6c04",<br />
"project_group_name": "Linux Tools",<br />
"projects": [<br />
{"id": "91630e84-db2f-4d8c-8716-68b7fdf17a66", "name": "bash"},<br />
{"id": "d3a17f52-...", "name": "coreutils"}<br />
]<br />
}</code><br />
<code>projects[].id</code> — это <code>project_id</code>, который далее передаётся в <code>get_snapshots</code>. Группы и проекты — разные сущности; идентификатор группы и идентификатор проекта не взаимозаменяемы.<br />
<br />
== Примеры сценариев ==<br />
Приведённые ниже запросы выполнены на демонстрационном стенде <code>svacer-demo.ispras.ru</code> с использованием OpenWebUI и модели <code>qwen3-coder:30b</code>. В любом другом MCP-клиенте с моделью достаточной мощности порядок вызовов будет аналогичным.<br />
<br />
=== Про объём ответа ===<br />
<code>get_markers</code>, <code>get_warnings</code> и <code>get_diff(level=2)</code> по умолчанию ограничивают объём ответа, чтобы не перегружать контекст модели:<br />
<br />
* <code>get_markers</code> и <code>get_warnings</code> — 30 маркеров по умолчанию. Если у <code>get_warnings</code> включены <code>traces</code>, <code>review_history</code> или <code>comment_history</code>, лимит снижается до 8, поскольку такие маркеры значительно объёмнее.<br />
* <code>get_diff(level=2)</code> — 20 маркеров на каждую категорию внутри <code>markers</code> (<code>new_markers</code>/<code>missing_markers</code>/<code>modified_markers</code>/<code>matched_markers</code>).<br />
<br />
В ответе присутствуют поля <code>total_count</code>, <code>returned_count</code>, <code>truncated</code>. При <code>truncated: true</code> есть два варианта действий: сузить фильтр (<code>severity</code>, <code>warnClass</code>, <code>file</code>) либо явно увеличить <code>limit</code> (значение <code>limit=0</code> полностью снимает ограничение).<br />
<br />
Поле <code>fields</code> определяет, какие ключи маркера возвращаются. По умолчанию применяется компактный набор <code>id, warnClass, file, line, msg, function, review</code> (а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены логическими флагами и пришли с сервера). Для полного маркера со всеми служебными ключами — <code>fields=["*"]</code>. Для произвольной выборки — список полей верхнего уровня, например <code>fields=["id","warnClass"]</code>. Поле <code>review</code> — объект <code>{status, severity, action}</code>; вложенные ключи в <code>fields</code> не поддерживаются, поэтому объект <code>review</code> запрашивается целиком.<br />
<br />
=== Перечислить все проекты ===<br />
<blockquote>Какие проекты есть в Svacer?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
<br />
'''Ответ модели:'''<blockquote>В Svacer доступно 6 проектов: bash, openssl, paho.mqtt.c, coturn, zstd, darpa. У каждого — одна ветка <code>master</code>.</blockquote><br />
<br />
=== Посмотреть снимки проекта ===<br />
<blockquote>Какие снимки есть у paho.mqtt.c? Самый свежий когда?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code> — найти <code>project_id</code> и <code>branch_id</code><br />
# <code>get_snapshots(project_id=..., branch_id=...)</code><br />
<br />
'''Ответ модели:'''<blockquote>У paho.mqtt.c 3 снимка. Самый свежий — «Snapshot 2020-03-25 09:09:41 +0300» (297 маркеров). Предыдущий — 20 марта (306 маркеров).</blockquote>Поле <code>commit_hash</code> может принимать значение <code>null</code>, если проект не сохраняет хэш коммита в <code>custom_properties</code>. Имена снимков произвольны: одни проекты записывают в имя дату, другие — коммит, третьи — свободный текст.<br />
<br />
=== Сводка по проекту ===<br />
<blockquote>Что в bash в последнем снимке? Сколько всего предупреждений, есть ли критические, какие топ-детекторы?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots(project_id, branch_id)</code> — взять последний снимок<br />
# <code>get_project_stats(project_id, branch_id, snapshot_id)</code><br />
<br />
'''Ответ модели:'''<blockquote>В последнем снимке bash содержится 771 предупреждение:<br />
<br />
* Критических: 1 (Confirmed)<br />
* Major: 1 (Won't fix)<br />
* Остальные: 769 (Unspecified — не ревьюились)<br />
<br />
Топ-детекторы по количеству:<br />
<br />
# <code>PROC_USE.VULNERABLE</code> — 337<br />
# <code>UNUSED_FUNC_RES.REWRITE.MINOR</code> — 44<br />
# <code>UNREACHABLE_CODE</code> — 28<br />
# <code>DEREF_AFTER_NULL.EX</code> — 27<br />
# <code>NULL_AFTER_DEREF</code> — 27<br />
</blockquote><code>Unspecified</code> в <code>by_severity</code> — маркеры без ручного ревью, а не «низкий приоритет». Поле <code>by_checker</code> не сортируется, на большом снимке оно может содержать более 100 ключей — чтобы получить именно топ-N, следует явно сформулировать запрос: «топ-5 детекторов».<br />
<br />
=== Тренд по нескольким снимкам ===<br />
<blockquote>Как у openssl менялось число предупреждений за последние пять снимков? Покажи таблицей.</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — взять список<br />
# <code>get_project_stats()</code> × 5 — по каждому из последних пяти снимков<br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
{| class="wikitable"<br />
|+<br />
!Снимок<br />
!Дата<br />
!Всего<br />
|-<br />
|2020-04-30 05:49<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:29<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:08<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:48<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:22<br />
|30.04.2020<br />
|1252<br />
|}<br />
</blockquote><br />
На демонстрационном стенде указанные пять снимков openssl импортированы с интервалом в 20 минут одного дня и полностью идентичны — поэтому динамика отсутствует. На реальном проекте с историей релизов значения будут изменяться.<br />
<br />
=== Найти срабатывания конкретного детектора ===<br />
<blockquote>Где в bash срабатывает PROC_USE.VULNERABLE? Покажи список — файл, строка, что именно ругается. Достаточно первых десяти.</blockquote>'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code><br />
# <code>get_markers(warnClass=["PROC_USE.VULNERABLE"])</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
# <code>/.build/lib/sh/tmpfile.c:160</code> — <code>mktemp()</code>, race condition. Рекомендуется <code>mkstemp()</code>.<br />
# <code>/.build/lib/readline/shell.c:151</code> — <code>getenv()</code>, значение может быть подменено.<br />
# <code>/.build/shell.c:415</code> — <code>getenv()</code> в <code>main()</code>.<br />
# <code>/.build/lib/readline/complete.c:1516</code> — <code>getenv()</code>.<br />
# <code>/.build/lib/sh/eaccess.c:115</code> — <code>strcat()</code>, рекомендуется <code>strncat()</code>. …<br />
</blockquote><br />
Фильтр <code>warnClass=["PROC_USE.VULNERABLE"]</code> охватывает все подклассы: <code>PROC_USE.VULNERABLE.TEMP</code>, <code>.GETENV</code>, <code>.STRCAT</code> и т. д. — всего 341 маркер. Несколько значений в одном параметре трактуются как логическое «ИЛИ»: <code>severity=["Critical","Major"]</code> возвращает маркеры обеих категорий.<br />
<br />
В ответе будет <code>total_count: 341, returned_count: 30, truncated: true</code> — это ожидаемое поведение. Модель видит общий объём по <code>total_count</code> и при необходимости сужает запрос или вызывает <code>get_markers(..., limit=0)</code>, чтобы получить полный список.<br />
<br />
=== Сравнить два снимка ===<br />
<blockquote>Возьми два последних снимка paho.mqtt.c — что между ними изменилось? Сколько новых предупреждений, сколько починили?</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — два последних<br />
# <code>get_diff(base_snapshot_id="72b3df7b-...", head_snapshot_id="b42cb563-...", level=0)</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote>Между двумя последними снимками paho.mqtt.c:<br />
<br />
* Новых: 12<br />
* Удалённых: 13<br />
* Изменённых: 99<br />
* Совпадающих: 185<br />
<br />
Удалено несколько больше, чем добавлено — общая картина практически не изменилась.</blockquote><br />
<br />
Категория <code>modified</code> — маркер, присутствующий в обоих снимках, у которого изменилось окружение (номер строки, контекст функции). Это не новая ошибка. На больших проектах рекомендуется начинать с <code>level=0</code> для получения статистики, при необходимости использовать <code>level=1</code> (только идентификаторы маркеров) и затем точечно вызывать <code>get_markers</code> с нужными фильтрами.<br />
<br />
<code>level=2</code> возвращает полные маркеры по категориям, причём каждая категория по умолчанию ограничена 20 маркерами. Категории располагаются внутри <code>markers</code>: <code>new_markers</code>, <code>missing_markers</code>, <code>modified_markers</code>, <code>matched_markers</code>. Структура ответа в JSON: <code><nowiki>{"markers": {"new_markers": {"total_count": N, "returned_count": ..., "truncated": ..., "markers": [...]}, ...}}</nowiki></code>. Если требуется полное содержимое категории, следует увеличить <code>limit</code> или выполнить отдельный вызов <code>get_markers</code> по нужным идентификаторам.<br />
<br />
=== Разобрать конкретное предупреждение ===<br />
<blockquote>В bash есть один подтверждённый критикал — что-то про разыменование указателя. Покажи код вокруг этого места и объясни в чём проблема.</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code> → <code>get_snapshots()</code> — найти снимок bash<br />
# <code>get_markers(severity=["Critical"], review=["Confirmed"])</code><br />
# <code>get_advanced_file_preview(file_path="/.build/execute_cmd.c", line=3327, before=10, after=10)</code><br />
<br />
'''Ответ модели:'''<blockquote>Маркер <code>DEREF_AFTER_NULL.LOOP</code> в функции <code>select_query()</code>, строка 3327:<br />
<code>for (l = list; l && --reply; l = l->next)<br />
<br />
;<br />
<br />
return (l->word->word); /* l может быть NULL после выхода из цикла */</code><br />
<br />
Если список заканчивается раньше, чем <code>reply</code> обнуляется, <code>l</code> станет <code>NULL</code> на последнем <code>l->next</code>, и следующий <code>l->word->word</code> — разыменование нулевого указателя.</blockquote><code>file_path</code> должен точно совпадать со значением, возвращённым маркером, включая ведущий префикс <code>/.build/...</code>. Это путь внутри сборочной директории Svacer, а не путь в исходном репозитории; соответствие в репозитории определяется по имени файла.<br />
<br />
Для одиночной разметки удобно сразу запрашивать полный маркер с трассами: <code>get_markers(..., severity=["Critical"], review=["Confirmed"], traces=True, checker_info=True)</code>. Флаги <code>traces</code> и <code>checker_info</code> указывают серверу включить соответствующие поля в ответ; в выдаче они сохраняются и при значении <code>fields</code> по умолчанию. Значение <code>fields=["*"]</code> требуется лишь в том случае, когда дополнительно нужны <code>tool</code> и <code>mtid</code> — служебные ключи, исключённые из компактного набора.</div>Mitrofanovhttps://svacer.ispras.ru/mediawiki/index.php?title=Help:13-alpha_MCP&diff=3502Help:13-alpha MCP2026-05-21T09:53:43Z<p>Mitrofanov: /* Тренд по нескольким снимкам */</p>
<hr />
<div>== Архитектура ==<br />
[https://modelcontextprotocol.io/docs/getting-started/intro MCP] — открытый стандарт, через который LLM-клиенты (Claude Desktop, Cursor, VS Code, OpenWebUI и др.) вызывают внешние инструменты. <br />
Svacer MCP соединяет одно с другим: 8 инструментов поверх публичного REST API Svacer, которые LLM выбирает и вызывает в ответ на обычный текстовый запрос. Вместо ручной последовательности «открыть UI, найти проект, выбрать снимок, применить фильтр» достаточно сформулировать вопрос в чате, например, «сколько критических предупреждений в последнем снимке bash?», и получить ответ. Необходимые вызовы инструментов модель выполняет самостоятельно.<br />
<br />
[[File:Архитектура MCP.png|thumb|none|x800px|alt=architectureMCP|Архитектура MCP-сервер]]<br />
<br />
Поток запроса: LLM-клиент отправляет MCP-вызов через STDIO или Streamable HTTP → <code>server.py</code> передаёт его в выбранный инструмент из <code>tools/</code> → инструмент проверяет параметры и обращается к <code>api_client.py</code> → клиент получает JWT от <code>auth.py</code> (модуль автоматически обновляет токен по истечении срока действия или при ответе 401) → запрос отправляется в Svacer REST API.<br />
<br />
== Установка ==<br />
Установка Svacer MCP, подключение клиентов и конфигурация.<br />
<br />
=== Требования ===<br />
<br />
* Python 3.10+<br />
* Доступ к Svacer-серверу: URL + логин/пароль<br />
<br />
=== Режим STDIO ===<br />
Подходит для настольных клиентов: Claude Desktop, Claude Code, Cursor, VS Code.<br />
<code>git clone <nowiki>https://gitlab.ispras.ru/svacerai/mcp.git</nowiki> && cd mcp<br />
<br />
python3 -m venv .venv<br />
.venv/bin/pip install -e .<br />
<br />
cp .env.example .env<br />
# Отредактировать .env — указать URL и учётные данные Svacer<br />
<br />
# Проверить запуск (сервер ожидает данные на stdin; для выхода — Ctrl+C)<br />
.venv/bin/svacer-mcp</code><br />
После <code>pip install -e .</code> в окружении становится доступна команда <code>svacer-mcp</code> — её указывают в конфигурации клиентов ниже.<br />
<br />
=== Режим HTTP (Docker) ===<br />
Подходит для веб-клиентов (OpenWebUI) и удалённого доступа.<br />
<br />
'''Требования:''' Docker, Docker Compose.<br />
<code>cp .env.example .env<br />
<br />
# В .env обязательно задать SVACER_MCP_TOKEN — без него сервер не запускается<br />
echo "SVACER_MCP_TOKEN=$(openssl rand -hex 32)" >> .env<br />
<br />
docker compose up -d<br />
<br />
# MCP endpoint: <nowiki>http://localhost:8002/mcp</nowiki><br />
# Клиенты передают заголовок: Authorization: Bearer <SVACER_MCP_TOKEN></code><br />
Внешний порт хоста задаётся переменной <code>MCP_PORT</code> (по умолчанию <code>8002</code>), внутри контейнера сервер всегда слушает порт <code>8000</code>.<br />
<br />
=== Подключение клиентов ===<br />
<br />
==== Claude Desktop ====<br />
Файл конфигурации: <code>~/.config/Claude/claude_desktop_config.json</code> (Linux) или <code>%APPDATA%\Claude\claude_desktop_config.json</code> (Windows).<br />
<br />
Укажите '''абсолютный путь''' к <code>svacer-mcp</code> из вашего venv (<code>which svacer-mcp</code> в активированном venv или <code>/path/to/mcp/.venv/bin/svacer-mcp</code>).<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Claude Code ====<br />
<code>claude mcp add svacer \<br />
-e SVACER_URL=<nowiki>https://your-svacer.example.com</nowiki> \<br />
-e SVACER_LOGIN=your-login \<br />
-e SVACER_PASSWORD=your-password \<br />
-- /path/to/mcp/.venv/bin/svacer-mcp</code><br />
<br />
==== VS Code ====<br />
Файл <code>.vscode/mcp.json</code> в корне рабочей директории:<br />
<code>{<br />
"servers": {<br />
"svacer": {<br />
"type": "stdio",<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== Cursor ====<br />
Файл <code>.cursor/mcp.json</code> в корне проекта или глобально:<br />
<code>{<br />
"mcpServers": {<br />
"svacer": {<br />
"command": "/path/to/mcp/.venv/bin/svacer-mcp",<br />
"env": {<br />
"SVACER_URL": "<nowiki>https://your-svacer.example.com</nowiki>",<br />
"SVACER_LOGIN": "your-login",<br />
"SVACER_PASSWORD": "your-password"<br />
}<br />
}<br />
}<br />
}</code><br />
<br />
==== OpenWebUI ====<br />
<br />
# Развернуть через Docker (см. «Режим HTTP» выше).<br />
# Открыть '''Settings → Tools''' (или '''Admin Panel → Settings → Tools''').<br />
# Добавить сервер:<br />
#* <code><nowiki>http://localhost:8002/mcp</nowiki></code> — если OpenWebUI работает на хосте, снаружи Docker.<br />
#* <code><nowiki>http://svacer-mcp:8000/mcp</nowiki></code> — если OpenWebUI развёрнут в той же compose-сети, что и <code>svacer-mcp</code> (имя берётся из <code>docker-compose.yml</code> → service name, порт 8000 — внутренний порт контейнера).<br />
# Тип подключения: '''MCP (Streamable HTTP)'''.<br />
# В настройках инструмента указать заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code> (значение — то же, что в <code>.env</code> сервера).<br />
# Сохранить — инструменты появятся в чате.<br />
<br />
=== Конфигурация ===<br />
{| class="wikitable"<br />
!Переменная<br />
!По умолчанию<br />
!Описание<br />
|-<br />
|<code>SVACER_URL</code><br />
|<code><nowiki>https://svacer-demo.ispras.ru</nowiki></code><br />
|URL Svacer-сервера<br />
|-<br />
|<code>SVACER_LOGIN</code><br />
|<code>admin</code><br />
|Логин<br />
|-<br />
|<code>SVACER_PASSWORD</code><br />
|<code>admin</code><br />
|Пароль<br />
|-<br />
|<code>SVACER_TIMEOUT</code><br />
|<code>30</code><br />
|Тайм-аут HTTP-запросов к Svacer, секунды<br />
|-<br />
|<code>SVACER_TRANSPORT</code><br />
|<code>stdio</code><br />
|Режим транспорта: <code>stdio</code> или <code>http</code><br />
|-<br />
|<code>SVACER_HTTP_PORT</code><br />
|<code>8000</code><br />
|TCP-порт сервера в режиме HTTP (внутри контейнера)<br />
|-<br />
|<code>SVACER_MCP_TOKEN</code><br />
|''(не задано)''<br />
|Bearer-токен для клиентов <code>/mcp</code>. Обязателен при <code>SVACER_TRANSPORT=http</code>, в режиме STDIO игнорируется. Генерация: <code>openssl rand -hex 32</code><br />
|-<br />
|<code>SVACER_MCP_RESOURCE_URL</code><br />
|<code><nowiki>http://localhost</nowiki>:<HTTP_PORT></code><br />
|Публичный URL MCP-сервера для заголовка <code>WWW-Authenticate</code> (<nowiki>RFC 9728</nowiki>). Задаётся при работе за обратным прокси<br />
|-<br />
|<code>SVACER_TOOLS</code><br />
|''(не задано)''<br />
|Список инструментов через запятую. Если не задано, регистрируются все 8<br />
|-<br />
|<code>MCP_PORT</code><br />
|<code>8002</code><br />
|Внешний порт хоста при запуске через <code>docker compose</code> (отображается на внутренний <code>SVACER_HTTP_PORT</code>)<br />
|}<br />
Переменные читаются из <code>.env</code> или из окружения. Для STDIO-клиентов их можно указать в секции <code>env</code> конфигурации клиента.<br />
<br />
==== Ограничение набора инструментов ====<br />
Чтобы запустить сервер с подмножеством инструментов (например, для уменьшения объёма контекста у модели или разграничения доступа), задайте <code>SVACER_TOOLS</code>:<br />
<code>SVACER_TOOLS=get_projects,get_snapshots,get_markers</code><br />
Допустимые имена: <code>get_projects</code>, <code>get_snapshots</code>, <code>get_warnings</code>, <code>get_markers</code>, <code>get_project_stats</code>, <code>get_project_groups</code>, <code>get_advanced_file_preview</code>, <code>get_diff</code>. Неизвестное имя в списке приводит к ошибке при запуске. Если переменная пустая или не задана, регистрируются все 8 инструментов.<br />
<br />
==== Несколько экземпляров сервера ====<br />
Параллельный запуск нескольких MCP-серверов поддерживается без ограничений.<br />
<br />
* В режиме STDIO каждая запись в конфигурации клиента описывает отдельный процесс — несколько подключений к разным экземплярам Svacer задаются простым перечислением.<br />
* В режиме HTTP запускаются независимые контейнеры на разных хост-портах: например, <code>MCP_PORT=8002</code> для одного экземпляра и <code>MCP_PORT=8003</code> для другого. Для каждого контейнера задаётся собственный <code>SVACER_MCP_TOKEN</code>.<br />
<br />
=== Безопасность ===<br />
<br />
* '''STDIO''': сервер не открывает сетевых портов и обменивается данными через стандартные потоки ввода/вывода процесса.<br />
* '''Streamable HTTP''': эндпоинт <code>/mcp</code> требует заголовок <code>Authorization: Bearer <SVACER_MCP_TOKEN></code>. Запросы без токена или с неверным значением получают ответ <code>401</code> и заголовок <code>WWW-Authenticate: Bearer ...</code>. Токен является разделяемым секретом и не заменяет TLS, а дополняет его: при работе за обратным прокси необходимо использовать HTTPS, а сам токен передавать только по защищённому каналу.<br />
* Без <code>SVACER_MCP_TOKEN</code> HTTP-сервер не запускается.<br />
* Учётные данные <code>admin/admin</code> предназначены только для тестового стенда. В рабочем окружении необходимо задать собственные логин и пароль через переменные окружения.<br />
* Файл <code>.env</code> не должен добавляться в систему контроля версий.<br />
<br />
==== Передача токена клиентом ====<br />
Большинство HTTP-клиентов MCP (OpenWebUI и др.) позволяют задать произвольный заголовок <code>Authorization</code> в настройках инструмента — указывается значение <code>Bearer <токен></code>. Для ручной проверки:<br />
<code>curl -H "Authorization: Bearer $SVACER_MCP_TOKEN" \<br />
<nowiki> </nowiki> -H 'Content-Type: application/json' \<br />
<nowiki> </nowiki> -H 'Accept: application/json, text/event-stream' \<br />
<nowiki> </nowiki> -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}' \<br />
<nowiki> </nowiki> <nowiki>http://localhost:8002/mcp</nowiki></code><br />
<br />
== Инструменты ==<br />
Справочник по 8 инструментам Svacer MCP. Типичный порядок вызовов: <code>get_projects</code> → <code>get_snapshots</code> → любой из аналитических инструментов.<br />
{| class="wikitable"<br />
!Инструмент<br />
!Назначение<br />
|-<br />
|<code>get_projects</code><br />
|Список проектов с ветками — точка входа<br />
|-<br />
|<code>get_snapshots</code><br />
|Снимки конкретной ветки, от нового к старому<br />
|-<br />
|<code>get_project_stats</code><br />
|Агрегированные метрики снимка: severity / review / checker<br />
|-<br />
|<code>get_markers</code><br />
|Компактный список маркеров с серверной фильтрацией<br />
|-<br />
|<code>get_warnings</code><br />
|Полные предупреждения с трассами и историей ревью<br />
|-<br />
|<code>get_diff</code><br />
|Сравнение двух снимков: new / missing / modified / matched<br />
|-<br />
|<code>get_advanced_file_preview</code><br />
|Фрагмент исходного кода вокруг строки<br />
|-<br />
|<code>get_project_groups</code><br />
|Группа проектов по имени или UUID<br />
|}<br />
<br />
=== get_projects ===<br />
Список всех проектов с ветками. Точка входа: с этого вызова начинается практически любой сценарий — он возвращает <code>project_id</code> и <code>branch_id</code>, необходимые для последующих запросов.<br />
<br />
'''Параметров нет.'''<br />
<br />
'''Вызов:'''<br />
<code>get_projects()</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"project_id": "91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
"project_name": "bash",<br />
"created": "2021-12-13T13:22:42.122456Z",<br />
"created_by": "admin",<br />
"branches": [<br />
{<br />
"branch_id": "77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
"branch_name": "master",<br />
"created": "2021-12-13T13:22:42.394812Z"<br />
}<br />
]<br />
}<br />
]</code><br />
----<br />
<br />
=== get_snapshots ===<br />
Список снимков для конкретной ветки проекта, от нового к старому.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|Из <code>get_projects</code><br />
|-<br />
|<code>name_filter</code><br />
|string<br />
|нет<br />
|Подстрока или regex для фильтра по имени снимка<br />
|}<br />
'''Вызов:'''<br />
<code>get_snapshots(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4"<br />
)</code><br />
'''Ответ:'''<br />
<code>[<br />
{<br />
"snapshot_id": "b42cb563-86f4-4f96-900a-7782163327c9",<br />
"name": "Snapshot 2020-03-25 09:09:41 +0300",<br />
"import_time": "2020-03-25T09:09:41.837296Z",<br />
"commit_hash": null,<br />
"markers_count": 297,<br />
"link": "<nowiki>https://svacer-demo.ispras.ru/</nowiki>..."<br />
}<br />
]</code><br />
----<br />
<br />
=== get_project_stats ===<br />
Агрегированные метрики по снимку: общее количество предупреждений, распределение по критичности, по статусу ревью, по детекторам. Наиболее быстрый способ получить общую картину по проекту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_stats(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9"<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_warnings": 771,<br />
"by_severity": {<br />
"Critical": 1,<br />
"Major": 1,<br />
"Unspecified": 769<br />
},<br />
"by_review_status": {<br />
"Confirmed": 1,<br />
"False Positive": 1,<br />
"Undecided": 767,<br />
"Unclear": 1,<br />
"Won't fix": 1<br />
},<br />
"by_checker": {<br />
"PROC_USE.VULNERABLE": 337,<br />
"UNUSED_FUNC_RES.REWRITE.MINOR": 44,<br />
"UNREACHABLE_CODE": 28,<br />
"DEREF_AFTER_NULL.EX": 27,<br />
"NULL_AFTER_DEREF": 27<br />
}<br />
}</code><br />
----<br />
<br />
=== get_markers ===<br />
Компактный список маркеров с серверной фильтрацией. Основной инструмент для перечисления и обзора: его следует предпочитать <code>get_warnings</code>, когда не требуются развёрнутые поля — трассы и история ревью.<br />
<br />
По умолчанию ответ ограничен 30 маркерами и содержит компактный набор полей. Подробнее об ограничении объёма см. раздел Про объём ответа в сценариях.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора (<code>DEREF_AFTER_NULL</code>, …)<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы маркеров<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю изменений ревью<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии к маркеру<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра из веб-интерфейса Svacer<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров в ответе (по умолчанию <code>30</code>). Значение <code>0</code> снимает ограничение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|Список разрешённых полей маркера верхнего уровня. По умолчанию — компактный набор <code>id, warnClass, file, line, msg, function, review</code>. Значение <code>["*"]</code> возвращает все поля коннектора (<code>id, warnClass, file, line, msg, tool, function, mtid, review</code>, а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены). Допустим и произвольный список — например, <code>["id","warnClass"]</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_markers(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
warnClass=["PROC_USE.VULNERABLE"]<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 341,<br />
"returned_count": 30,<br />
"truncated": true,<br />
"filters_applied": {"warnClass": ["PROC_USE.VULNERABLE"]},<br />
"markers": [<br />
{<br />
"id": "e05bb35b-a95e-4eb2-85ae-3101b788f07d",<br />
"warnClass": "PROC_USE.VULNERABLE.TEMP",<br />
"file": "/.build/lib/sh/tmpfile.c",<br />
"line": 160,<br />
"msg": "Use of vulnerable function 'mktemp' at tmpfile.c:160. ...",<br />
"function": "sh_mktmpname",<br />
"review": null<br />
}<br />
]<br />
}</code><br />
<code>total_count</code> отражает количество маркеров, удовлетворяющих фильтру до применения ограничения; <code>returned_count</code> — количество маркеров, фактически содержащихся в <code>markers</code>. При <code>truncated: true</code> следует либо сузить фильтры (<code>severity</code>, <code>warnClass</code>, <code>file</code>), либо передать <code>limit=0</code> для получения полного списка. Поля <code>tool</code> и <code>mtid</code> возвращаются только при <code>fields=["*"]</code>.<br />
----<br />
<br />
=== get_warnings ===<br />
Полные предупреждения с детальной разметкой. Ответ значительно объёмнее, чем у <code>get_markers</code>, поэтому инструмент следует использовать только тогда, когда нужны поля, отсутствующие в компактной форме: <code>traces</code>, <code>review_history</code>, <code>checker_info</code>, <code>comment_history</code>.<br />
<br />
Лимит по умолчанию — 30; при включённых <code>traces</code>, <code>review_history</code> или <code>comment_history</code> он автоматически снижается до 8, поскольку такие предупреждения существенно объёмнее.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>project_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>branch_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>severity</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Critical</code>, <code>Major</code>, <code>Minor</code>, <code>Unspecified</code>. Фильтр по <code>review.severity</code>, применяется на стороне коннектора<br />
|-<br />
|<code>review</code><br />
|<code>string[]</code><br />
|нет<br />
|<code>Confirmed</code>, <code>Won't fix</code>, <code>False Positive</code>, <code>Unclear</code><br />
|-<br />
|<code>warnClass</code><br />
|<code>string[]</code><br />
|нет<br />
|Идентификатор детектора<br />
|-<br />
|<code>file</code><br />
|<code>string[]</code><br />
|нет<br />
|Подстрока пути к файлу<br />
|-<br />
|<code>traces</code><br />
|<code>bool</code><br />
|нет<br />
|Включить трассы. Активирует режим расширенных полей (лимит по умолчанию — 8)<br />
|-<br />
|<code>checker_info</code><br />
|<code>bool</code><br />
|нет<br />
|Включить метаданные детектора (CWE, описание)<br />
|-<br />
|<code>review_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить историю ревью. Режим расширенных полей<br />
|-<br />
|<code>comment_history</code><br />
|<code>bool</code><br />
|нет<br />
|Включить комментарии. Режим расширенных полей<br />
|-<br />
|<code>custom_filter</code><br />
|string<br />
|нет<br />
|Имя или идентификатор сохранённого фильтра<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество предупреждений в ответе. По умолчанию — <code>30</code>, в режиме расширенных полей — <code>8</code>. Значение <code>0</code> снимает ограничение. Явно заданное <code>limit</code> отменяет автоматическое снижение<br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code><br />
|}<br />
'''Вызов:'''<br />
<code>get_warnings(<br />
project_id="91630e84-db2f-4d8c-8716-68b7fdf17a66",<br />
branch_id="77f66b9e-0453-4ae9-a187-88950b4c4bc4",<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
severity=["Critical"],<br />
review_history=True,<br />
traces=True<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"total_count": 1,<br />
"returned_count": 1,<br />
"truncated": false,<br />
"filters_applied": {"severity": ["Critical"], "traces": true, "review_history": true},<br />
"warnings": [<br />
{<br />
"id": "a3f21c90-1d4e-4b82-9f63-7c8e5d2a1b09",<br />
"warnClass": "DEREF_AFTER_NULL.LOOP",<br />
"file": "/.build/execute_cmd.c",<br />
"line": 3327,<br />
"msg": "Possible null pointer dereference of 'l' after loop exit.",<br />
"function": "select_query",<br />
"review": {"status": "Confirmed", "severity": "Critical"},<br />
"review_history": [{"status": "Confirmed", "changed_by": "admin", "changed_at": "2021-12-13T14:00:00Z"}],<br />
"traces": [{"file": "/.build/execute_cmd.c", "line": 3320, "msg": "Loop starts here; 'l' may exhaust the list."}]<br />
}<br />
]<br />
}</code><br />
----<br />
<br />
=== get_diff ===<br />
Сравнение двух снимков. Категории располагаются под ключом <code>markers</code>: <code>new_markers</code> (появилось в новом снимке), <code>missing_markers</code> (исчезло из нового), <code>modified_markers</code> (тот же идентификатор, изменился контекст), <code>matched_markers</code> (совпало в обоих). Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно UUID снимков.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>base_snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|Старый снимок<br />
|-<br />
|<code>head_snapshot_id</code><br />
|string (UUID)<br />
|нет<br />
|Новый снимок; если не указан, сравнение выполняется с предыдущим по времени<br />
|-<br />
|<code>level</code><br />
|int<br />
|нет<br />
|<code>0</code> — только статистика; <code>1</code> — статистика и идентификаторы маркеров; <code>2</code> — полные маркеры по категориям<br />
|-<br />
|<code>checker_info</code><br />
|bool<br />
|нет<br />
|Метаданные детекторов для маркеров (только при <code>level >= 2</code>)<br />
|-<br />
|<code>limit</code><br />
|int<br />
|нет<br />
|Максимальное количество маркеров '''на каждую категорию''' при <code>level >= 2</code>. По умолчанию — <code>20</code>, значение <code>0</code> снимает ограничение. Параметр игнорируется при <code>level < 2</code><br />
|-<br />
|<code>fields</code><br />
|<code>string[]</code><br />
|нет<br />
|См. описание у <code>get_markers</code>/<code>get_warnings</code>. Применяется к маркерам внутри категорий при <code>level >= 2</code><br />
|}<br />
'''Вызов (<code>level=0</code>):'''<br />
<code>get_diff(<br />
base_snapshot_id="72b3df7b-c15a-4e3d-8f92-a041dc6e5b87",<br />
head_snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
level=0<br />
)</code><br />
'''Ответ (<code>level=0</code>):'''<br />
<code>{<br />
"stats": {<br />
"context1": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-20 ..."},<br />
"context2": {"projectName": "paho.mqtt.c", "snapshotName": "Snapshot 2020-03-25 ..."},<br />
"scope": ["NEW", "MISSING", "MATCHED", "MODIFIED"],<br />
"new": 9,<br />
"missing": 12,<br />
"modified": 98,<br />
"matched": 187<br />
}<br />
}</code><br />
'''Ответ (<code>level=2</code>)''' — каждая категория внутри <code>markers</code> оформляется и ограничивается независимо:<br />
<code>{<br />
"stats": {"new": 50, "missing": 5, "modified": 0, "matched": 187},<br />
"markers": {<br />
"new_markers": {<br />
"total_count": 50,<br />
"returned_count": 20,<br />
"truncated": true,<br />
"markers": [<br />
{"id": "a3f21c90-...", "warnClass": "DEREF_AFTER_NULL.LOOP", "file": "...", "line": 3327, "msg": "...", "function": "select_query", "review": null}<br />
]<br />
},<br />
"missing_markers": {"total_count": 5, "returned_count": 5, "truncated": false, "markers": [...]},<br />
"modified_markers": {"total_count": 0, "returned_count": 0, "truncated": false, "markers": []},<br />
"matched_markers": {"total_count": 187, "returned_count": 20, "truncated": true, "markers": [...]}<br />
}<br />
}</code><br />
Если требуется полное содержимое категории, следует увеличить <code>limit</code> либо запросить нужные идентификаторы отдельным вызовом <code>get_markers</code>. Маркеры внутри категорий проходят ту же компактную обработку, что и в <code>get_warnings</code>: значение <code>fields=["*"]</code> возвращает фиксированный набор полей коннектора, а не произвольные «сырые» поля API.<br />
----<br />
<br />
=== get_advanced_file_preview ===<br />
Фрагмент исходного кода из снимка вокруг указанной строки. Параметры <code>project_id</code> и <code>branch_id</code> не требуются — достаточно идентификатора снимка и пути к файлу.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>snapshot_id</code><br />
|string (UUID)<br />
|да<br />
|<br />
|-<br />
|<code>file_path</code><br />
|string<br />
|да<br />
|Путь к файлу в том виде, в котором его возвращают <code>get_markers</code> и <code>get_warnings</code><br />
|-<br />
|<code>line</code><br />
|int<br />
|нет<br />
|Центральная строка, нумерация с 1 (по умолчанию <code>1</code>)<br />
|-<br />
|<code>before</code><br />
|int<br />
|нет<br />
|Количество строк до центральной (по умолчанию <code>0</code>)<br />
|-<br />
|<code>after</code><br />
|int<br />
|нет<br />
|Количество строк после центральной (по умолчанию <code>99999</code> — до конца файла)<br />
|}<br />
'''Вызов:'''<br />
<code>get_advanced_file_preview(<br />
snapshot_id="b42cb563-86f4-4f96-900a-7782163327c9",<br />
file_path="/.build/execute_cmd.c",<br />
line=3327,<br />
before=10,<br />
after=10<br />
)</code><br />
'''Ответ:'''<br />
<code>{<br />
"line": 3327,<br />
"content": " for (l = list; l && --reply; l = l->next)\n\t;\n return (l->word->word);\n",<br />
"total_lines": 6082<br />
}</code><br />
----<br />
<br />
=== get_project_groups ===<br />
Получить группу проектов по имени или UUID. Группы объединяют проекты в логические блоки — например, по команде или продукту.<br />
<br />
'''Параметры.'''<br />
{| class="wikitable"<br />
!Имя<br />
!Тип<br />
!Обязательный<br />
!Описание<br />
|-<br />
|<code>name_or_id</code><br />
|string<br />
|да<br />
|Имя группы или её UUID<br />
|}<br />
'''Вызов:'''<br />
<code>get_project_groups(name_or_id="Linux Tools")</code><br />
'''Ответ:'''<br />
<code>{<br />
"project_group_id": "c4f8a2d1-3b7e-4f90-82ac-1d5e8f2b6c04",<br />
"project_group_name": "Linux Tools",<br />
"projects": [<br />
{"id": "91630e84-db2f-4d8c-8716-68b7fdf17a66", "name": "bash"},<br />
{"id": "d3a17f52-...", "name": "coreutils"}<br />
]<br />
}</code><br />
<code>projects[].id</code> — это <code>project_id</code>, который далее передаётся в <code>get_snapshots</code>. Группы и проекты — разные сущности; идентификатор группы и идентификатор проекта не взаимозаменяемы.<br />
<br />
== Примеры сценариев ==<br />
Приведённые ниже запросы выполнены на демонстрационном стенде <code>svacer-demo.ispras.ru</code> с использованием OpenWebUI и модели <code>qwen3-coder:30b</code>. В любом другом MCP-клиенте с моделью достаточной мощности порядок вызовов будет аналогичным.<br />
<br />
=== Про объём ответа ===<br />
<code>get_markers</code>, <code>get_warnings</code> и <code>get_diff(level=2)</code> по умолчанию ограничивают объём ответа, чтобы не перегружать контекст модели:<br />
<br />
* <code>get_markers</code> и <code>get_warnings</code> — 30 маркеров по умолчанию. Если у <code>get_warnings</code> включены <code>traces</code>, <code>review_history</code> или <code>comment_history</code>, лимит снижается до 8, поскольку такие маркеры значительно объёмнее.<br />
* <code>get_diff(level=2)</code> — 20 маркеров на каждую категорию внутри <code>markers</code> (<code>new_markers</code>/<code>missing_markers</code>/<code>modified_markers</code>/<code>matched_markers</code>).<br />
<br />
В ответе присутствуют поля <code>total_count</code>, <code>returned_count</code>, <code>truncated</code>. При <code>truncated: true</code> есть два варианта действий: сузить фильтр (<code>severity</code>, <code>warnClass</code>, <code>file</code>) либо явно увеличить <code>limit</code> (значение <code>limit=0</code> полностью снимает ограничение).<br />
<br />
Поле <code>fields</code> определяет, какие ключи маркера возвращаются. По умолчанию применяется компактный набор <code>id, warnClass, file, line, msg, function, review</code> (а также <code>traces</code>/<code>checkerInfo</code>/<code>review_history</code>/<code>comments</code>, если они запрошены логическими флагами и пришли с сервера). Для полного маркера со всеми служебными ключами — <code>fields=["*"]</code>. Для произвольной выборки — список полей верхнего уровня, например <code>fields=["id","warnClass"]</code>. Поле <code>review</code> — объект <code>{status, severity, action}</code>; вложенные ключи в <code>fields</code> не поддерживаются, поэтому объект <code>review</code> запрашивается целиком.<br />
<br />
=== Перечислить все проекты ===<br />
<blockquote>Какие проекты есть в Svacer?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
<br />
'''Ответ модели:'''<blockquote>В Svacer доступно 6 проектов: bash, openssl, paho.mqtt.c, coturn, zstd, darpa. У каждого — одна ветка <code>master</code>.</blockquote><br />
<br />
=== Посмотреть снимки проекта ===<br />
<blockquote>Какие снимки есть у paho.mqtt.c? Самый свежий когда?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code> — найти <code>project_id</code> и <code>branch_id</code><br />
# <code>get_snapshots(project_id=..., branch_id=...)</code><br />
<br />
'''Ответ модели:'''<blockquote>У paho.mqtt.c 3 снимка. Самый свежий — «Snapshot 2020-03-25 09:09:41 +0300» (297 маркеров). Предыдущий — 20 марта (306 маркеров).</blockquote>Поле <code>commit_hash</code> может принимать значение <code>null</code>, если проект не сохраняет хэш коммита в <code>custom_properties</code>. Имена снимков произвольны: одни проекты записывают в имя дату, другие — коммит, третьи — свободный текст.<br />
<br />
=== Сводка по проекту ===<br />
<blockquote>Что в bash в последнем снимке? Сколько всего предупреждений, есть ли критические, какие топ-детекторы?</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots(project_id, branch_id)</code> — взять последний снимок<br />
# <code>get_project_stats(project_id, branch_id, snapshot_id)</code><br />
<br />
'''Ответ модели:'''<blockquote>В последнем снимке bash содержится 771 предупреждение:<br />
<br />
* Критических: 1 (Confirmed)<br />
* Major: 1 (Won't fix)<br />
* Остальные: 769 (Unspecified — не ревьюились)<br />
<br />
Топ-детекторы по количеству:<br />
<br />
# <code>PROC_USE.VULNERABLE</code> — 337<br />
# <code>UNUSED_FUNC_RES.REWRITE.MINOR</code> — 44<br />
# <code>UNREACHABLE_CODE</code> — 28<br />
# <code>DEREF_AFTER_NULL.EX</code> — 27<br />
# <code>NULL_AFTER_DEREF</code> — 27<br />
</blockquote><code>Unspecified</code> в <code>by_severity</code> — маркеры без ручного ревью, а не «низкий приоритет». Поле <code>by_checker</code> не сортируется, на большом снимке оно может содержать более 100 ключей — чтобы получить именно топ-N, следует явно сформулировать запрос: «топ-5 детекторов».<br />
<br />
=== Тренд по нескольким снимкам ===<br />
<blockquote>Как у openssl менялось число предупреждений за последние пять снимков? Покажи таблицей.</blockquote>'''Цепочка вызовов:'''<br />
<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — взять список<br />
# <code>get_project_stats()</code> × 5 — по каждому из последних пяти снимков<br />
<br />
'''Ответ модели:'''<br />
{| class="wikitable"<br />
|+<br />
!Снимок<br />
!Дата<br />
!Всего<br />
|-<br />
|2020-04-30 05:49<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:29<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 05:08<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:48<br />
|30.04.2020<br />
|1252<br />
|-<br />
|2020-04-30 04:22<br />
|30.04.2020<br />
|1252<br />
|}<br />
На демонстрационном стенде указанные пять снимков openssl импортированы с интервалом в 20 минут одного дня и полностью идентичны — поэтому динамика отсутствует. На реальном проекте с историей релизов значения будут изменяться.<br />
<br />
=== Найти срабатывания конкретного детектора ===<br />
<blockquote>Где в bash срабатывает PROC_USE.VULNERABLE? Покажи список — файл, строка, что именно ругается. Достаточно первых десяти.</blockquote>'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code><br />
# <code>get_markers(warnClass=["PROC_USE.VULNERABLE"])</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote><br />
# <code>/.build/lib/sh/tmpfile.c:160</code> — <code>mktemp()</code>, race condition. Рекомендуется <code>mkstemp()</code>.<br />
# <code>/.build/lib/readline/shell.c:151</code> — <code>getenv()</code>, значение может быть подменено.<br />
# <code>/.build/shell.c:415</code> — <code>getenv()</code> в <code>main()</code>.<br />
# <code>/.build/lib/readline/complete.c:1516</code> — <code>getenv()</code>.<br />
# <code>/.build/lib/sh/eaccess.c:115</code> — <code>strcat()</code>, рекомендуется <code>strncat()</code>. …<br />
</blockquote><br />
Фильтр <code>warnClass=["PROC_USE.VULNERABLE"]</code> охватывает все подклассы: <code>PROC_USE.VULNERABLE.TEMP</code>, <code>.GETENV</code>, <code>.STRCAT</code> и т. д. — всего 341 маркер. Несколько значений в одном параметре трактуются как логическое «ИЛИ»: <code>severity=["Critical","Major"]</code> возвращает маркеры обеих категорий.<br />
<br />
В ответе будет <code>total_count: 341, returned_count: 30, truncated: true</code> — это ожидаемое поведение. Модель видит общий объём по <code>total_count</code> и при необходимости сужает запрос или вызывает <code>get_markers(..., limit=0)</code>, чтобы получить полный список.<br />
<br />
=== Сравнить два снимка ===<br />
<blockquote>Возьми два последних снимка paho.mqtt.c — что между ними изменилось? Сколько новых предупреждений, сколько починили?</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code><br />
# <code>get_snapshots()</code> — два последних<br />
# <code>get_diff(base_snapshot_id="72b3df7b-...", head_snapshot_id="b42cb563-...", level=0)</code><br />
<br />
'''Ответ модели:'''<br />
<blockquote>Между двумя последними снимками paho.mqtt.c:<br />
<br />
* Новых: 12<br />
* Удалённых: 13<br />
* Изменённых: 99<br />
* Совпадающих: 185<br />
<br />
Удалено несколько больше, чем добавлено — общая картина практически не изменилась.</blockquote><br />
<br />
Категория <code>modified</code> — маркер, присутствующий в обоих снимках, у которого изменилось окружение (номер строки, контекст функции). Это не новая ошибка. На больших проектах рекомендуется начинать с <code>level=0</code> для получения статистики, при необходимости использовать <code>level=1</code> (только идентификаторы маркеров) и затем точечно вызывать <code>get_markers</code> с нужными фильтрами.<br />
<br />
<code>level=2</code> возвращает полные маркеры по категориям, причём каждая категория по умолчанию ограничена 20 маркерами. Категории располагаются внутри <code>markers</code>: <code>new_markers</code>, <code>missing_markers</code>, <code>modified_markers</code>, <code>matched_markers</code>. Структура ответа в JSON: <code><nowiki>{"markers": {"new_markers": {"total_count": N, "returned_count": ..., "truncated": ..., "markers": [...]}, ...}}</nowiki></code>. Если требуется полное содержимое категории, следует увеличить <code>limit</code> или выполнить отдельный вызов <code>get_markers</code> по нужным идентификаторам.<br />
<br />
=== Разобрать конкретное предупреждение ===<br />
<blockquote>В bash есть один подтверждённый критикал — что-то про разыменование указателя. Покажи код вокруг этого места и объясни в чём проблема.</blockquote><br />
'''Цепочка вызовов:'''<br />
# <code>get_projects()</code> → <code>get_snapshots()</code> — найти снимок bash<br />
# <code>get_markers(severity=["Critical"], review=["Confirmed"])</code><br />
# <code>get_advanced_file_preview(file_path="/.build/execute_cmd.c", line=3327, before=10, after=10)</code><br />
<br />
'''Ответ модели:'''<blockquote>Маркер <code>DEREF_AFTER_NULL.LOOP</code> в функции <code>select_query()</code>, строка 3327:<br />
<code>for (l = list; l && --reply; l = l->next)<br />
<br />
;<br />
<br />
return (l->word->word); /* l может быть NULL после выхода из цикла */</code><br />
<br />
Если список заканчивается раньше, чем <code>reply</code> обнуляется, <code>l</code> станет <code>NULL</code> на последнем <code>l->next</code>, и следующий <code>l->word->word</code> — разыменование нулевого указателя.</blockquote><code>file_path</code> должен точно совпадать со значением, возвращённым маркером, включая ведущий префикс <code>/.build/...</code>. Это путь внутри сборочной директории Svacer, а не путь в исходном репозитории; соответствие в репозитории определяется по имени файла.<br />
<br />
Для одиночной разметки удобно сразу запрашивать полный маркер с трассами: <code>get_markers(..., severity=["Critical"], review=["Confirmed"], traces=True, checker_info=True)</code>. Флаги <code>traces</code> и <code>checker_info</code> указывают серверу включить соответствующие поля в ответ; в выдаче они сохраняются и при значении <code>fields</code> по умолчанию. Значение <code>fields=["*"]</code> требуется лишь в том случае, когда дополнительно нужны <code>tool</code> и <code>mtid</code> — служебные ключи, исключённые из компактного набора.</div>Mitrofanov