SkillFoxx

Начните вводить название, задачу или сервис

MCP-сервер для 1С:Напарник

Spring Boot MCP Server для 1С:Напарник

MCP-сервер на Spring Boot и Kotlin, который подключает агента к API 1С:Напарник для вопросов и проверки кода 1С

MCP-серверСредний рискРоссийский стек

steelmorgan/spring-mcp-1c-copilotАвтор: SteelMorgan

Установка

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.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проксирует запросы агента в 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С на проблемы производительности и объясни, что делает метод ВыполнитьПакет

Ограничения

Нужен токен 1С:Напарник, полученный на code.1c.ai. Для запуска требуется Java 17 или Docker. Docker Compose по умолчанию подключает контейнер к внешней сети infra, вне песочницы автора сеть придется настроить самостоятельно. Лицензия разрешает только личное и некоммерческое использование.

Как отключить. Удалите блок 1c-copilot-proxy из ~/.cursor/mcp.json и остановите контейнер командой docker compose down.

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С:Напарник
  • Код, отправленный на проверку, уходит во внешний API
  • Запускает Docker-контейнер с HTTP-сервером

Коротко о README

Проект реализует MCP-сервер для 1С:Напарник на Spring Boot и Kotlin и развивает идеи artesk/1copilot_MCP и rentgengl/copilot-1c-proxy. Описаны три MCP-инструмента, REST-эндпоинты и Swagger UI. Приведены локальный запуск через Gradle, запуск в Docker, переменные окружения и подключение к Cursor. Отдельно описано безопасное хранение токена в файле.

Частые вопросы

Как безопасно хранить токен?

Скрипт ./scripts/prepare-token-secret.sh переносит токен из .env в файл .secrets/onec_ai_token, путь к нему задается ONEC_AI_TOKEN_FILE.

Зачем режим raw?

ONEC_AI_SKILL_NAME=raw используется по умолчанию: для справочного режима он стабильнее и не уводит Напарника во внутренние tool_calls.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.
Выбор редакции

Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом

MCP-серверСредний риск62 тыс.