BSL MCP Analyzer
MCP-анализатор кода 1С BSL: диагностика по всему проекту, сложность методов и приоритеты рефакторинга без Java
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструменты анализируют и агрегируют диагностику, не меняют код и не пишут в проект
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/bsl-mcp-analyzerОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport http bsl-trade http://HOST:8080/bsl/proj-a/mcp --header 'Authorization: Bearer <ваш AUTHORIZATION>'Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bsl-trade": {
"type": "http",
"url": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bsl-trade": {
"url": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"bsl-trade","type":"http","url":"http://HOST:8080/bsl/proj-a/mcp","headers":{"Authorization":"Bearer <ваш AUTHORIZATION>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bsl-trade": {
"type": "http",
"url": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bsl-trade]
url = "http://HOST:8080/bsl/proj-a/mcp"
http_headers = { Authorization = "Bearer <ваш AUTHORIZATION>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bsl-trade": {
"httpUrl": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bsl-trade": {
"serverUrl": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"bsl-trade": {
"type": "streamableHttp",
"url": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"bsl-trade": {
"type": "streamable-http",
"url": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bsl-trade": {
"type": "remote",
"url": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bsl-trade": {
"url": "http://HOST:8080/bsl/proj-a/mcp",
"headers": {
"Authorization": "Bearer <ваш AUTHORIZATION>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
AUTHORIZATIONсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Склонируй axel-avb/mcp-bsl-analyzer, заполни .env токеном BSL_MCP_TOKEN и путями PROJ_A_PATH, подними docker compose up -d --build и подключи агента по адресу http://HOST:8080/bsl/proj-a/mcp с заголовком Authorization Bearer.
Другие способы из описания автора
cp .env.example .env
docker compose up -d --buildВ .env указывается BSL_MCP_TOKEN и пути PROJ_A_PATH, PROJ_B_PATH, PROJ_C_PATH к проектам на хосте.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер надстраивает над движком onec-hbk-bsl (чистый Python, без Java и LSP-моста) три новых инструмента: complexity считает цикломатическую и когнитивную сложность каждого метода с порогами, module_health объединяет сложность с диагностикой безопасности, производительности и SQL и выдает ранжированный список top_targets на рефакторинг, workspace_diagnostics агрегирует более 180 правил линтера по всему проекту с группировкой по правилу, серьезности и файлу. От движка также наследуются навигация по символам, определения, ссылки, вызывающие и вызываемые методы, поиск, переименование и форматирование. Сервер разворачивается в Docker с nginx перед собой: один контейнер на проект, доступ по Bearer-токену на путь /bsl/<project>/mcp.
Для кого. Для 1С-разработчиков и тимлидов, которым нужна количественная оценка сложности BSL-кода и приоритеты рефакторинга без установки Java-инструментов.
Подходит, если
- Нужны числовые метрики цикломатической и когнитивной сложности по методам BSL
- Нужен список, что рефакторить в первую очередь, а не просто список предупреждений
- Нужна линтер-диагностика по всему проекту 1С с агрегацией по файлам и правилам
Не подходит, если
- Нет Linux-хоста с Docker Engine 24+ для развертывания
- Нужен только просмотр или поиск по коду без анализа сложности и линтера
- Проект слишком мал, чтобы иметь смысл в ранжировании рефакторинга
Пример запроса к агенту
Покажи топ модулей на рефакторинг в этом проекте 1С и когнитивную сложность самого сложного методаОграничения
Разворачивается только в Docker на Linux, на проект нужно 2 ГБ ОЗУ и около 2 CPU, индексация крупных конфигураций нагружает CPU и диск. Инструмент зависит от отдельного проекта onec-hbk-bsl как движка. Лицензия не подтверждена автоматически через GitHub API, часть README доступна только на английском в основном файле.
Как отключить. Остановите контейнер проекта командой docker compose down и удалите сервер из конфигурации MCP-клиента.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| BSL_MCP_TOKEN обязательная, секрет | Bearer-токен для доступа к проектам через nginx |
Проверка безопасности
- Инструменты анализируют и агрегируют диагностику, не меняют код и не пишут в проект
Коротко о README
README на английском (есть версия на русском в README.ru.md) объясняет, что проект переиспользует движок onec-hbk-bsl и добавляет три недостающих инструмента: числовую сложность, сводку здоровья модуля и агрегацию по всему проекту. Показана архитектура через nginx с Bearer-авторизацией, быстрый старт docker compose, проверка curl-запросом со статусом 200 и 401, и примеры конфигурации для opencode и клиентов формата mcpServers вроде Cursor.
Частые вопросы
Нужна ли Java?
Нет, движок onec-hbk-bsl написан на чистом Python и не требует Java или LSP-моста.
Можно анализировать несколько проектов одним сервером?
Каждый проект получает свой контейнер bsl-<proj>, но все они проксируются одним nginx на разных путях.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything