Skip to main content

MCP server for 1C:Partner AI assistant - provides tools for 1C development support

Project description

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

Возможности

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

  • Современный, адаптивный интерфейс чата
  • Управление историей разговоров с изолированными контекстами (история хранится локально в браузере)
  • Подсветка синтаксиса для кода 1C (BSL) и XML с автоопределением
  • Прикрепление файлов (.bsl, .xml, .txt)
  • Просмотр содержимого прикрепленных файлов в браузере
  • Поиск по содержимому прикрепленных файлов
  • Визуализация mermaid диаграмм с возможностью сохранить в png
  • Поиск по истории сообщений
  • Экспорт истории разговоров в JSON
  • Отображение статистики токенов (входящие/исходящие/всего)
  • Копирование сообщений в буфер обмена
  • Контекстное меню форматирования кода с горячими клавишами

Интерфейс чата

🔧 MCP сервер

  • Доступные инструменты:
    • ask_1c_ai - Общие вопросы и советы по 1C:Предприятие
    • explain_1c_syntax - Объяснение конкретных объектов/синтаксиса 1C с контекстом
    • check_1c_code - Проверка и валидация кода на ошибки (syntax/logic/performance)

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

  • Полная совместимость с API OpenAI Chat Completions (/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. Начните общение:

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

    {
      "mcpServers": {   
        "1c-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="")
    

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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_roctup_1c_buddy-0.1.0.tar.gz (937.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_roctup_1c_buddy-0.1.0-py3-none-any.whl (918.4 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_roctup_1c_buddy-0.1.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_roctup_1c_buddy-0.1.0.tar.gz
  • Upload date:
  • Size: 937.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_roctup_1c_buddy-0.1.0.tar.gz
Algorithm Hash digest
SHA256 5440d7fe80f4446298b2966404d8c924e17afc2617996cf78e082a8371c67953
MD5 d68d5b4cb927a8561e9830d3bc0b36b2
BLAKE2b-256 e21c4d453abbb6ae9ef3900ba08ccf8ec86032ad02de71fb3b20294f085e0eca

See more details on using hashes here.

File details

Details for the file iflow_mcp_roctup_1c_buddy-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_roctup_1c_buddy-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 918.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_roctup_1c_buddy-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9dfa8e6f2d017b85d6e1d7e32e2591cdf34ca73462a7ae09f982b5025d2d4025
MD5 6ce7c5da05297ab8b7a93fb5dd1a959c
BLAKE2b-256 f8e1a973db0b713a4c0ec53877ed0ee8ee615a614a82ac02e849c520671373b5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page