⚡ Легковесный MCP-сервер для графа метаданных 1С:Предприятие
_{🧠 Memgraph + Python FastMCP — в 3 раза меньше RAM чем Neo4j}

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

Ваш AI-ассистент получает полное структурное знание о конфигурации 1С:

• 📦 Все объекты метаданных (справочники, документы, регистры, перечисления и т.д.)
• 📝 Реквизиты, ресурсы, измерения с типами
• 🖥️ Формы, элементы управления, события, привязки
• 💻 BSL-код: процедуры, функции, сигнатуры, граф вызовов
• 🔐 Роли и права доступа
• 🔗 Перекрёстные ссылки между объектами (USED_IN)
• 📌 Предопределённые элементы

Оригинальный подход использует Neo4j (графовая БД на JVM). На типичных машинах это означает:

                  Memgraph (bolt://7687)
                        |
       +--------+-------+-------+--------+
       |        |       |       |        |
   erp_main  erp_ext  ssl3  do_main  do_ext
    :6001     :6002   :6003  :6004   :6005
       (Python FastMCP, SSE транспорт)

• 🗄️ Memgraph -- графовая БД (Bolt-протокол, Cypher-запросы, совместима с Neo4j-драйвером)
• 🐍 MCP-сервисы -- Python 3.12 + FastMCP, SSE-транспорт
• 🔒 Все проекты используют один Memgraph, изолированы по project_name

Каждому проекту нужна директория с:

ваш-проект/
  metadata/
    ОтчетПоКонфигурации.txt     # Отчет по конфигурации (UTF-16 или UTF-8)
  code/
    ConfigDumpInfo.xml            # GUID-маппинг (опционально)
    ОбщиеМодули/                  # BSL исходники
    Справочники/
    Документы/
    ...

📋 Экспорт отчёта по конфигурации из Конфигуратора 1С: Конфигурация -> Отчёт по конфигурации (выбрать все объекты, сохранить как .txt)

Отредактируйте lite/docker-compose.yml -- замените /path/to/erp_main на реальный путь:

volumes:
  - /path/to/erp_main:/app/data

⚠️ Для Windows: используйте локальные пути типа C:\1c-data\erp_main, НЕ UNC-пути.

cd lite/
docker compose up -d

✅ Всё! Memgraph стартует за ~3 секунды, MCP-сервер начинает принимать запросы мгновенно, данные загружаются в фоне.

# 👀 Проверить что контейнеры запущены
docker ps

# 🔍 Тест SSE-эндпоинта (ожидаемый ответ: 200)
curl -s -o /dev/null -w "%{http_code}" http://localhost:6001/sse --max-time 5

claude mcp add erp_main --transport sse http://localhost:6001/sse

Или в ~/.claude/settings.json:

{
  "mcpServers": {
    "erp_main": { "type": "sse", "url": "http://localhost:6001/sse" }
  }
}

SSE-эндпоинт: http://localhost:6001/sse

Основной инструмент. Принимает JSON с полем "op":

{"op": "list_categories"}
{"op": "list_objects_by_name", "name": "Контрагенты"}
{"op": "object_structure", "name": "ДокументыПредприятия"}
{"op": "list_attributes_with_type", "name": "АМЕ_ДоговорыКонтрагентов"}
{"op": "find_routines_by_name", "name": "ОтправитьЗапрос"}
{"op": "get_routine_body", "id": "do_ext/АМЕ/CommonModules/КоннекторHTTP.ОтправитьЗапрос"}
{"op": "find_usages_of_object", "name": "Контрагенты"}

{"op": "find_routines_by_description", "text": "HTTP", "export": true}
{"op": "get_routine_body", "name": "ВыполнитьЗапрос"}

{"text": "премия"}
{"text": "контрагент", "category": "Справочники"}

Скопируйте блок сервиса в lite/docker-compose.yml:

1c-metacode-ssl3:
  image: svhov/1c-metacode-lite
  build: ./mcp-service
  restart: unless-stopped
  ports:
    - "6003:6001"                         # уникальный порт на хосте
  volumes:
    - /path/to/ssl3:/app/data             # ваши данные
  environment:
    - PROJECT_NAME=ssl3                   # уникальное имя
    - MEMGRAPH_URI=bolt://memgraph:7687
    - MCP_PORT=6001
    - FULL_METADATA_RELOAD=true
  depends_on:
    memgraph:
      condition: service_healthy

Project
  +-- Configuration
        +-- MetadataCategory
              +-- MetadataObject
                    |-- Attribute (с type_info)
                    |-- Resource
                    |-- Dimension
                    |-- TabularPart
                    |     +-- Attribute
                    |-- Form
                    |     |-- FormControl --BINDS_TO--> FormAttribute
                    |     +-- FormEvent
                    |-- EnumValue
                    |-- PredefinedItem
                    |-- Command
                    |-- Layout
                    +-- Module
                          +-- Routine --CALLS--> Routine

MetadataObject --USED_IN--> MetadataObject
MetadataObject --GRANTS_ACCESS_TO--> MetadataObject (роли)

• 🚫 Нет векторного/embedding поиска -- только шаблонные запросы, LLM не нужен
• 🚫 Нет запросов на естественном языке -- только JSON-операции (by design: ноль внешних зависимостей)
• 🔤 Поиск по кириллице -- toLower() в Memgraph не работает с кириллицей; поиск использует множественные варианты регистра из Python
• 🔗 USED_IN связи строятся только из типов реквизитов (СправочникСсылка.X), не из всех возможных ссылок

Сухов Андрей 🎯 Автор проекта

Claude (Anthropic) 🤖 AI co-author

Jeremiah Lowin ⚡ Автор FastMCP

MIT

Если проект оказался полезен, можете поддержать автора 🙏

   ⭐ Если проект полезен — поставьте звезду!