1C Buddy - Чат, MCP сервер и OpenAI совместимый API шлюз для общения с 1С:Напарник

Возможности

💬 Веб-интерфейс чата

• Современный, адаптивный интерфейс чата

• Управление историей разговоров с изолированными контекстами (история хранится локально в браузере)

• Ответы в реальном времени с потоковой передачей

• Отдельное отображение tool call / tool result / follow-up блоков

• Пользовательские инструкции рабочего пространства

• Подключение внешних HTTP MCP серверов прямо из настроек чата

• Отображение reasoning-дельт в процессе генерации

• Подсветка синтаксиса для кода 1C (BSL) и XML с автоопределением

• Прикрепление файлов (.bsl, .xml, .txt)

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

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

• Визуализация mermaid диаграмм с возможностью сохранить в png

• Поиск по истории сообщений

• Экспорт истории разговоров в JSON

• Отображение статистики токенов (входящие/исходящие/всего)

• Копирование сообщений в буфер обмена

• Контекстное меню форматирования кода с горячими клавишами

🔧 MCP сервер

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

  • ask_1c_ai - общие вопросы по платформе 1С и практическим сценариям

  • explain_1c_syntax - объяснение конкретного объекта, метода или конструкции 1С

  • check_1c_code - синтаксическая проверка или code review фрагмента кода 1С

  • modify_1c_code - изменение кода 1С по явному заданию пользователя

  • search_1c_documentation - поиск по документации платформы 1С:Предприятие

  • search_its - поиск по базе знаний ИТС

  • fetch_its - получение содержимого конкретного документа или раздела ИТС по id

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

🚀 OpenAI-совместимый API

• OpenAI-совместимый формат для /v1/models и /v1/chat/completions

• Потоковые и непотоковые ответы с поддержкой Server-Sent Events (SSE)

• Стандартная аутентификация с Bearer токенами

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

1. Получите токен code.1c.ai с сайта code.1c.ai

2. Запустите с Docker:

   docker pull roctup/1c-buddy
   
   docker run -d --name 1c-buddy --restart unless-stopped -p 6002:6002 -e "ONEC_AI_TOKEN=<your_1c_ai_token>" roctup/1c-buddy 

   Если нужен также OpenAI API шлюз:

   docker pull roctup/1c-buddy
   
   docker run -d --name 1c-buddy --restart unless-stopped -p 6002:6002 -e "ONEC_AI_TOKEN=<your_1c_ai_token>" -e "OPENAI_COMPAT_API_KEY=<your_custom_api_key>" roctup/1c-buddy 

3. Начните общение:

   • Веб-интерфейс чата: http://localhost:6002/chat

   Дополнительные настройки чата скрыты по умолчанию. Чтобы включить пользовательские инструкции и внешние MCP серверы, запустите контейнер с флагами:

   docker run -d --name 1c-buddy --restart unless-stopped -p 6002:6002 \
     -e "ONEC_AI_TOKEN=<your_1c_ai_token>" \
     -e "CHAT_CUSTOM_INSTRUCTIONS_ENABLED=true" \
     -e "CHAT_CUSTOM_MCP_ENABLED=true" \
     roctup/1c-buddy

   После этого в чате появится кнопка настроек. В ней можно задать инструкции рабочего пространства и подключить внешние Streamable HTTP MCP серверы, например http://192.168.0.1:6003/mcp.

4. Настройте MCP для IDE:

   {
     "mcpServers": {   
       "onec-buddy-mcp": {
         "url": "http://localhost:6002/mcp",
         "connection_id": "1c_buddy_service_001",
         "alwaysAllow": [],
         "type": "streamable-http",
         "timeout": 300,
         "disabled": false
      }
    }
   }

5. Отправляйте запросы по OpenAI API:

   Используйте любой OpenAI SDK или клиентскую библиотеку:

   from openai import OpenAI
   
   client = OpenAI(
   	base_url="http://localhost:6002/v1",
   	api_key="your_custom_api_key"
   )
   
   # Непотоковый режим
   response = client.chat.completions.create(
   	model="1c-buddy",
   	messages=[{"role": "user", "content": "Как создать HTTPСоединение в 1С?"}]
   )
   print(response.choices[0].message.content)
   
   # Потоковый режим
   for chunk in client.chat.completions.stream(
   	model="1c-buddy",
   	messages=[{"role": "user", "content": "Объясни объект Запрос"}]
   ):
   	print(chunk.choices[0].delta.content, end="")

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

Подробная документация доступна в README_FULL.md.

Благодарности

Огромное спасибо автору оригинального проекта MCP сервера для 1С:Напарник: artesk/1copilot_MCP