MCP-мост к 1С:Напарник на Go
1c-copilot-mcp
Go-бинарник с 5 MCP-инструментами к нейросети 1С:Напарник, который читает код 1С прямо из файла по пути, а не через контекст модели
- 9 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает файлы проекта напрямую с диска в пределах ALLOWED_CODE_PATHS и отправляет их содержимое во внешний сервис code.1c.ai
- Хранит токен доступа в переменных окружения конфигурации клиента
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/EugeneVl/1c-copilot-mcp.git
cd 1c-copilot-mcp
go buildСборка из исходников, нужен установленный Go.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает файлы проекта напрямую с диска в пределах ALLOWED_CODE_PATHS и отправляет их содержимое во внешний сервис code.1c.ai
- Хранит токен доступа в переменных окружения конфигурации клиента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает пять инструментов к API 1С:Напарник: комплексную проверку кода, поиск по ИТС и типовым конфигурациям, консультации, объяснение синтаксиса и исследование кодовой базы. Ключевая особенность: инструменты, работающие с кодом, принимают file_path и диапазон строк вместо самого текста кода, сервер сам читает нужный фрагмент из файла проекта, что экономит контекст модели и исключает искажения при копировании через LLM. Доступ к файлам ограничивается переменной ALLOWED_CODE_PATHS. Версия платформы автоматически добавляется в каждый запрос, сессии переиспользуются с TTL, а ответы нормализуются по NFKC и маркерам кода. Отдельный файл 1c-copilot.md написан от первого лица для ИИ-модели и должен подключаться в контекст, чтобы агент знал правила выбора инструмента и параметра file_path.
Для кого. Для 1С-разработчиков с токеном 1С:Напарник, у которых большие BSL-модули не помещаются в контекст модели при обычной передаче кода.
Подходит, если
- Модуль слишком большой, чтобы копировать его в промпт целиком
- Важно, чтобы код передавался в 1С:Напарник без искажений от копирования через модель
- Нужен доступ к 1С:Напарник из VS Code, Cursor, Claude Desktop или Windsurf с единым конфигом
Не подходит, если
- Нет токена 1С:Напарник с code.1c.ai
- Код нужно передавать напрямую текстом, а не через file_path: тогда параметр ALLOWED_CODE_PATHS и чтение файлов не нужны
- Нужен готовый бинарник без ручной сборки, а релиз v0.1.0 на момент README единственный опубликованный
Пример запроса к агенту
Проверь модуль по пути src/CommonModules/ОбщегоНазначения/Module.bsl со строки 100 по 250MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
ONEC_AI_TOKENобязательная, секрет- Обязательный токен API code.1c.ai.
ALLOWED_CODE_PATHS- Разрешенные пути для чтения файлов по file_path, по умолчанию только текущая папка.
ONEC_AI_LOG_FIELDS- Список полей для логирования (prompt, reasoning, answer), логирование выключено если переменная не задана.
Ограничения
Сборка из исходников требует установленный Go, альтернативный путь это готовый бинарник из релиза v0.1.0 на GitHub. Чтение по file_path поддерживает только инструмент check_1c_code, остальные принимают текст. Логирование в 1c-copilot.log пишется рядом с бинарником и включается только при заданной ONEC_AI_LOG_FIELDS, важно не хранить в логе секреты. Нужен токен 1С:Напарник: по данным code.1c.ai, ключ бесплатен до 1 февраля 2027 года. Это независимая community-обертка, а не сервер вендора.
Как отключить. Удалите блок 1c-copilot из mcpServers конфигурации клиента и папку с бинарником 1c-copilot-mcp.exe.
Частые вопросы
Зачем передавать file_path, а не сам код?
Сервер сам читает фрагмент из файла, это экономит контекст модели на больших модулях и исключает искажения текста при копировании через LLM.
Обязательно ли подключать 1c-copilot.md?
Да, README прямо говорит, что без этого файла модель не знает ключевых правил, например что использовать file_path вместо code.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер к API 1С:Напарник
1C AI MCP
Docker-сервер на FastMCP с 12 инструментами анализа BSL-кода и поиска по документации через API 1С:Напарник (code.1c.ai)
1C-ai-mcp: MCP-мост к 1С:Напарнику
1C-ai-mcp
MCP-сервер, который открывает облачного ассистента 1С:Напарник (1C.ai) и локальный BSL Language Server агентам в Cursor и других IDE
MCP-прокси к 1С:Напарнику
1c-ai-mcp
MCP-сервер, который пробрасывает вопросы, проверку и объяснение BSL-кода в облачный AI-ассистент 1С:Напарник
MCP-сервер на Go одним бинарником: агент видит метаданные базы 1С, ищет по коду, выполняет запросы на чтение и пишет точный BSL
MCP-сервер для 1С:Напарник
Spring Boot MCP Server для 1С:Напарник
MCP-сервер на Spring Boot и Kotlin, который подключает агента к API 1С:Напарник для вопросов и проверки кода 1С
MCP-сервер на Go для отладки 1С через HTTP Debug Protocol: точки останова, пошаговое выполнение и просмотр переменных
Из блога
Коротко о README
README описывает Go MCP-сервер с 5 инструментами к 1С:Напарник, таблицу переменных окружения, механизм чтения кода по file_path с обоснованием экономии контекста и контроля доступа через ALLOWED_CODE_PATHS, настройку логирования через ONEC_AI_LOG_FIELDS. Отдельный крупный раздел написан как пошаговая инструкция для ИИ-модели: как спросить пользователя про способ установки, собрать из исходников или скачать бинарник, получить токен и определить формат конфигурации конкретного MCP-клиента перед тем как его менять.