MCP-сервер для 1С:Напарник
Spring Boot MCP Server для 1С:Напарник
MCP-сервер на Spring Boot и Kotlin, который подключает агента к API 1С:Напарник для вопросов и проверки кода 1С
- 47 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Нужен токен 1С:Напарник
- Код, отправленный на проверку, уходит во внешний API
- Запускает Docker-контейнер с HTTP-сервером
Установка
- Работает в
- Сервисы
Ручная установка
cp env.example .env
./scripts/prepare-token-secret.sh
docker build -f Dockerfile.build -t spring-mcp-1c-copilot .
docker compose up -dПеред запуском скрипта вставьте токен в строку ONEC_AI_TOKEN в .env.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Нужен токен 1С:Напарник
- Код, отправленный на проверку, уходит во внешний API
- Запускает Docker-контейнер с HTTP-сервером
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проксирует запросы агента в API 1С:Напарник на code.1c.ai. Дает три инструмента: ask_1c_ai для вопросов, explain_1c_syntax для объяснения элементов синтаксиса и check_1c_code для проверки кода на синтаксические, логические ошибки и проблемы производительности. Работает по Streamable HTTP или SSE, дополнительно открывает REST API и Swagger UI.
Для кого. Разработчикам 1С с доступом к 1С:Напарник, которые пишут код в Cursor или Codex.
Подходит, если
- Нужен справочный ответ по платформе 1С прямо из агента
- Проверить фрагмент кода 1С на ошибки и производительность
- Объяснить незнакомый элемент синтаксиса встроенного языка
Не подходит, если
- Нет токена 1С:Напарник
- Планируется коммерческое использование без разрешения автора
Пример запроса к агенту
Проверь этот код 1С на проблемы производительности и объясни, что делает метод ВыполнитьПакетMCP
- Транспорт
- http, sse
- Авторизация
- API-ключ
Переменные окружения
ONEC_AI_TOKENобязательная, секрет- Токен доступа к API 1С:Напарник
ONEC_AI_TOKEN_FILE- Путь к файлу с токеном вместо ONEC_AI_TOKEN
ONEC_AI_BASE_URL- Базовый URL API, по умолчанию https://code.1c.ai
ONEC_AI_SKILL_NAME- Режим сессии Напарника, по умолчанию raw
SSE_PORT- Порт сервера, по умолчанию 8000
Ограничения
Нужен токен 1С:Напарник, полученный на code.1c.ai. Для запуска требуется Java 17 или Docker. Docker Compose по умолчанию подключает контейнер к внешней сети infra, вне песочницы автора сеть придется настроить самостоятельно. Лицензия разрешает только личное и некоммерческое использование.
Как отключить. Удалите блок 1c-copilot-proxy из ~/.cursor/mcp.json и остановите контейнер командой docker compose down.
Частые вопросы
Как безопасно хранить токен?
Скрипт ./scripts/prepare-token-secret.sh переносит токен из .env в файл .secrets/onec_ai_token, путь к нему задается ONEC_AI_TOKEN_FILE.
Зачем режим raw?
ONEC_AI_SKILL_NAME=raw используется по умолчанию: для справочного режима он стабильнее и не уводит Напарника во внутренние tool_calls.
Обсуждение
Вопросов и отзывов пока нет.
MCP-прокси к 1С:Напарнику
1c-ai-mcp
MCP-сервер, который пробрасывает вопросы, проверку и объяснение BSL-кода в облачный AI-ассистент 1С:Напарник
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С:Напарник на Go
1c-copilot-mcp
Go-бинарник с 5 MCP-инструментами к нейросети 1С:Напарник, который читает код 1С прямо из файла по пути, а не через контекст модели
Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации
1C MCP Server с прокси на FastAPI
1C MCP Server
Расширение 1С с HTTP-сервисом MCP плюс Python-прокси на FastAPI, который добавляет транспорт stdio, OAuth2 и Docker-запуск
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP-сервер для 1С:Напарник (эта запись) | нет | API-ключ | 47 | |
| browser-use-mcp-server | нет | API-ключ | 849 | управляет браузером через Playwright |
| MCP-сервер для Kommo CRM | нет | OAuth | 0 | на Python, с OAuth-авторизацией для Kommo |
| MCP-сервер для API GigaChat | нет | API-ключ | 0 | небольшой сервер для API GigaChat от Сбера |
Из блога
Коротко о README
Проект реализует MCP-сервер для 1С:Напарник на Spring Boot и Kotlin и развивает идеи artesk/1copilot_MCP и rentgengl/copilot-1c-proxy. Описаны три MCP-инструмента, REST-эндпоинты и Swagger UI. Приведены локальный запуск через Gradle, запуск в Docker, переменные окружения и подключение к Cursor. Отдельно описано безопасное хранение токена в файле.