1CCodeChecker

Проверка, анализ и работа с кодом и документацией 1С через сервис 1С:Напарник.

Назначение

1CCodeChecker — MCP-сервер, построенный на базе FastMCP, который интегрируется с сервисом 1С:Напарник (code.1c.ai). Предоставляет ИИ-ассистенту набор из 11 инструментов для полноценной работы с экосистемой 1С:Предприятие:

• Проверка и анализ кода (синтаксис, логика, производительность, стиль)

• Переписывание и модификация кода с автоматической валидацией

• Поиск по документации платформы с поддержкой версий

• Работа с базой знаний ИТС (поиск, чтение документов, стандарты)

• Сравнение документации между версиями платформы

• Поиск по документации прикладных конфигураций (ERP, БП, УТ и др.)

• Свободные вопросы к ИИ-ассистенту 1С:Напарник

Возможности

ИИ получает инструменты для:

• Проверки кода — синтаксические ошибки, логические проблемы, производительность

• Ревью кода — стиль, стандарты ИТС, именование, структура, комментирование

• Переписывания кода — ИИ предлагает улучшенную версию с объяснениями

• Модификации кода — точное выполнение инструкций пользователя

• Поиска по документации платформы — с указанием версии (v8.3.x, v8.5.x)

• Поиска по базе знаний ИТС — стандарты, методики, статьи

• Чтения документов ИТС — получение полного содержимого по ID

• Сравнения версий документации — что изменилось между версиями платформы

• Поиска по конфигурациям — документация прикладных решений

• Свободных вопросов — любые вопросы по разработке на 1С

Примеры использования

• "Проверь этот код на ошибки" → check_1c_code

• "Проведи code review этого модуля" → review_1c_code

• "Перепиши этот код, улучши производительность" → rewrite_1c_code

• "Добавь обработку ошибок в эту процедуру" → modify_1c_code

• "Что такое РегистрНакопления в 1С?" → onec_help

• "Найди в документации v8.3.25 описание HTTP-соединений" → search_1c_documentation

• "Какие стандарты именования переменных в ИТС?" → its_help

• "Что изменилось между v8.3.25 и v8.5.1?" → diff_1c_documentation_versions

• "Как работает проведение документов в ERP?" → config_help

• "Объясни разницу между ОбщийМодуль и МодульОбъекта" → ask_1c_ai

Требования

• Docker Desktop с WSL2

• Лицензионный ключ MCP (LICENSE_KEY)

• Токен 1С:Напарник (ONEC_AI_TOKEN, только для подписчиков ИТС)

• Доступ в интернет к code.1c.ai

Токен 1С:Напарник доступен подписчикам ИТС. Оформить подписку можно на developer.1c.ru. Если у вас нет подписки, используйте SyntaxCheckServer как альтернативу для проверки синтаксиса.

Доступные инструменты MCP

ИИ получает 11 инструментов:

Анализ и работа с кодом

Инструмент	Описание
ask_1c_ai	Свободный вопрос к ИИ 1С:Напарник (с поддержкой контекста диалога)
check_1c_code	Проверка кода: синтаксис, логика, производительность
review_1c_code	Code review: стиль, стандарты ИТС, именование, структура
rewrite_1c_code	Переписывание кода ИИ с улучшениями и объяснениями
modify_1c_code	Модификация кода по явной инструкции пользователя

Документация и база знаний

Инструмент	Описание
search_1c_documentation	Поиск в документации платформы (с указанием версии)
onec_help	Поиск в документации платформы (последняя версия)
its_help	Поиск по базе знаний ИТС (стандарты, методики, статьи)
fetch_its	Чтение содержимого документа ИТС по ID
diff_1c_documentation_versions	Сравнение документации между версиями платформы
config_help	Поиск документации по прикладным конфигурациям (ERP, БП, ЗУП и др.)

Подробное описание каждого инструмента — в разделе Инструменты.

Порт

8007

Образ Docker

comol/1c-code-checker:latest

Быстрый старт

docker run -d -p 8007:8007 `
  --name 1c_code_checker `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e ONEC_AI_TOKEN=YOUR_NAPARNIR_TOKEN `
  comol/1c-code-checker:latest

Конфигурация Cursor

{
  "mcpServers": {
    "1c-code-checker-mcp": {
      "url": "http://localhost:8007/mcp",
      "connection_id": "1c_code_checker_001"
    }
  }
}

Режимы вызова инструментов

Сервер поддерживает два режима работы (переменная MCP_TOOL_CALL_MODE):

• direct (по умолчанию) — инструменты вызывают upstream-инструменты 1С.ai напрямую для более точных результатов

• standard — все инструменты работают через промпты (текстовые запросы)

Подробнее — в разделе Конфигурация.

Оригинальная идея

github.com/artesk/1copilot_MCP

Структура раздела

• Установка — команды запуска и проверка работы

• Получение токена — как получить токен 1С:Напарник

• Инструменты — подробное описание всех 11 инструментов

• Конфигурация — переменные окружения и режимы работы