1C_MCP_SERVER_OWN

Доработка и адаптация MCP 1С под текущие задачи при работе с Агентами

Источник разработки: https://github.com/vladimir-kharin/1c_mcp

MCP-прокси сервер для 1С:Предприятие - мост между AI-агентами (Claude, Cursor) и вашей базой 1С. Получайте метаданные, анализируйте структуру конфигурации и генерируйте код через естественный язык!

✨ Что это такое

Представьте, что у вас есть мощный ИИ-помощник, который может "разговаривать" с вашей базой 1С. Этот прокси-сервер как переводчик: он берет запросы от ИИ на понятном ему языке (MCP-протокол) и переводит их в команды, которые понимает 1С.

Простыми словами:

• 🤖 ИИ спрашивает: "Какие справочники есть в конфигурации?"
• 🔄 Прокси переводит это в JSON-RPC запрос к 1С
• 📊 1С отвечает списком справочников
• ✅ Прокси переводит ответ обратно для ИИ

🎯 Ключевые возможности

• 🔄 Два режима работы: stdio (для локальных программ) и HTTP (для веб-приложений)
• 🔐 Безопасность: OAuth2 авторизация - каждый пользователь работает под своими учетными данными
• ⚡ Быстродействие: асинхронная обработка, поддержка множества одновременных пользователей
• 🔧 Универсальность: работает со всеми типами MCP-клиентов
• 📊 Аналитика: получение метаданных, структуры объектов, предопределенных данных

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

⚡ Установка (2 минуты)

# 1. Клонируйте репозиторий
git clone https://github.com/your-repo/1c-mcp-server.git
cd 1c-mcp-server

# 2. Создайте виртуальное окружение
python -m venv venv

# 3. Активируйте окружение
venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux/Mac

# 4. Установите зависимости
pip install -r requirements.txt

🚀 Первый запуск

Вариант A: Stdio режим (для локальных клиентов)

# Настройте переменные окружения
set MCP_ONEC_URL=http://localhost/base
set MCP_ONEC_USERNAME=admin
set MCP_ONEC_PASSWORD=password

# Запустите сервер
python -m src.py_server stdio

Вариант B: HTTP режим (для веб-клиентов)

# Создайте файл конфигурации
copy env.example .env

# Отредактируйте .env (минимум):
# MCP_ONEC_URL=http://localhost/base
# MCP_ONEC_USERNAME=admin
# MCP_ONEC_PASSWORD=password

# Запустите сервер
python -m src.py_server http --port 8000

✅ Проверка работы

# Проверьте здоровье сервера
curl http://localhost:8000/health

# Ожидаемый ответ:
{
  "status": "healthy",
  "onec_connection": "ok",
  "auth": {"mode": "none"}
}

📋 API Методы

🔍 list_metadata_objects

Получить список объектов метаданных указанного типа.

{
  "name": "list_metadata_objects",
  "arguments": {
    "metaType": "Catalogs",
    "nameMask": "Номенклатура",
    "maxItems": 10
  }
}

Результат: Список найденных объектов с именами и описаниями.

📋 get_metadata_structure

Получить подробную структуру объекта (реквизиты, табличные части).

{
  "name": "get_metadata_structure",
  "arguments": {
    "metaType": "Catalogs",
    "name": "Номенклатура"
  }
}

Результат: Полная структура объекта с типами данных.

🎯 list_predefined_data

Получить список предопределенных элементов.

{
  "name": "list_predefined_data",
  "arguments": {
    "metaType": "Catalogs",
    "name": "Номенклатура",
    "predefinedMask": "Услуга"
  }
}

📄 get_predefined_data

Получить детальную информацию о предопределенном элементе.

{
  "name": "get_predefined_data",
  "arguments": {
    "metaType": "Catalogs",
    "name": "Номенклатура",
    "predefinedName": "Услуга"
  }
}

⚙️ Конфигурация

Основные параметры

| Параметр | Описание | По умолчанию | Обязательный | |

... View full README on GitHub