1C-ai-mcp: MCP-мост к 1С:Напарнику
1C-ai-mcp
MCP-сервер, который открывает облачного ассистента 1С:Напарник (1C.ai) и локальный BSL Language Server агентам в Cursor и других IDE
- 22 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- rename_symbol и format_bsl_code изменяют исходный код проекта
- Токен ONEC_AI_TOKEN и содержимое кода уходят во внешний облачный сервис 1С.ai
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/novoros-id/1C-ai-mcp.git && cd 1C-ai-mcp && pip install -r requirements.txtПосле установки зависимостей нужно создать .env с ONEC_AI_TOKEN.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- rename_symbol и format_bsl_code изменяют исходный код проекта
- Токен ONEC_AI_TOKEN и содержимое кода уходят во внешний облачный сервис 1С.ai
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает облачный сервис 1С:Напарник (1C.ai) в MCP-инструменты ask_1C_expert и explain_1C_syntax для вопросов по платформе, а локальный bsl-language-server встраивает как audit_code_expert, check_bsl_standards, format_bsl_code, get_code_completions и rename_symbol для статического анализа, форматирования и переименования символов в BSL-коде. Отдельно есть pack_project и analyze_project для упаковки проекта в контекст через Repomix, git_analyze_diff и git_conflict_helper для коммитов и мержей, debug_version_compare и generate_method_docs. При старте сервер сам определяет наличие Java и Node.js, недостающие инструменты (аудит, упаковка) автоматически отключаются, а BSL Language Server может фоново обновляться с GitHub. Для облачных инструментов нужен токен ONEC_AI_TOKEN, получаемый на code.1c.ai через учетную запись 1С:ИТС.
Для кого. Для 1С-разработчиков в Cursor или другой IDE на базе VS Code, которые хотят сочетать облачные подсказки 1С:Напарника со статическим анализом BSL в одном MCP-сервере.
Подходит, если
- Уже есть доступ к 1С:Напарнику и токен ONEC_AI_TOKEN
- Нужен гибридный аудит кода: BSL Language Server плюс объяснение ИИ
- Нужны форматирование, автодополнение и безопасный рефакторинг BSL прямо через MCP
Не подходит, если
- Нет учетной записи 1С:ИТС для получения токена 1C.ai
- Нет возможности установить Java и Node.js в окружении: часть инструментов отключится
- Нужен полностью локальный сервер без обращения к облачному сервису 1С
Пример запроса к агенту
Проведи гибридный аудит модуля ОбщийМодуль1.bsl и объясни, что не так с найденными нарушениями стандартовMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
ONEC_AI_TOKENобязательная, секрет- Токен доступа к облачному сервису 1C.ai, выпускается в личном кабинете code.1c.ai по учетной записи 1С:ИТС.
CODEBASE_OUTPUT_NAME- Имя файла, в который Codebase Manager упаковывает проект, необязательная настройка.
Ограничения
Ключевые инструменты ask_1C_expert и explain_1C_syntax зависят от облачного сервиса 1C.ai и требуют токена, который выдается на code.1c.ai (по данным сервиса, ключ бесплатен до 1 февраля 2027 года). Аудит через BSL Language Server требует Java 11+, упаковка проекта через Repomix требует Node.js и npm, без них соответствующие инструменты отключаются без падения сервера. rename_symbol меняет исходный код и ссылки на него, стоит проверять результат перед коммитом.
Как отключить. Остановите MCP-сервер и удалите его из конфигурации MCP клиента, а токен ONEC_AI_TOKEN уберите из .env.
Частые вопросы
Что если нет Java или Node.js?
Сервер продолжит работать, но инструменты аудита и упаковки проекта автоматически отключатся.
Где взять токен ONEC_AI_TOKEN?
На code.1c.ai после входа через учетную запись 1С:ИТС, в панели управления.
Обсуждение
Вопросов и отзывов пока нет.
MCP-прокси к 1С:Напарнику
1c-ai-mcp
MCP-сервер, который пробрасывает вопросы, проверку и объяснение BSL-кода в облачный AI-ассистент 1С:Напарник
MCP-сервер к API 1С:Напарник
1C AI MCP
Docker-сервер на FastMCP с 12 инструментами анализа BSL-кода и поиска по документации через API 1С:Напарник (code.1c.ai)
Мост MCP к BSL Language Server
bsl-mcp-bridge
MCP-сервер в Docker, который держит запущенным BSL Language Server и отдает агенту навигацию по коду 1С, диагностику и рефакторинг вместо grep-поиска
MCP-мост к BSL Language Server: навигация, диагностика и рефакторинг кода 1С и OneScript для агентов
Среда разработки 1С с MCP-сервером на 10 инструментов: 11 анализаторов BSL, JSON DSL в XML, граф зависимостей и сборка EPF без 1С
MCP-мост к 1С:Напарник на Go
1c-copilot-mcp
Go-бинарник с 5 MCP-инструментами к нейросети 1С:Напарник, который читает код 1С прямо из файла по пути, а не через контекст модели
Коротко о README
README подробно описывает четыре слоя функциональности (1С:Напарник, BSL-анализатор, Codebase Manager, git-интеграция), технические решения вроде стратегии Triple-Nest для API 1C.ai и SSE-парсинга, установку через pip и auto_setup.py, получение токена на code.1c.ai, системные требования (Java 11+, Node.js, Python 3.10+) и полный список из десяти MCP-инструментов с описанием.