mcp-1c-com

MCP-сервер для 1С:Предприятие через COM — Cursor / Claude / другие MCP-клиенты получают доступ к данным информационной базы без расширений и без правки конфигурации.

Работает с УПП, КА, УТ, ERP и любыми другими конфигурациями на платформе 8.3 (Windows).

Зачем это нужно

Типовой путь «MCP как расширение 1С» (HTTP-сервис в .cfe) не работает на старых режимах совместимости — например УПП 1.3 с режимом 8.2.13 не умеет хранить расширения.

Этот проект обходит ограничение:

AI-клиент  →  MCP (stdio)  →  Python  →  V83.COMConnector  →  ИБ 1С

В конфигурацию ничего не ставится. Нужны только Windows, платформа 1С и доступ к базе.

Related MCP server: onec-meta-mcp

Возможности

Несколько баз = несколько MCP-серверов в .cursor/mcp.json (один и тот же server.py, разные ONEC_*).

Требования

• Windows x64

• 1С:Предприятие 8.3 (зарегистрированный V83.COMConnector / comcntr.dll)

• Python 3.10+ той же разрядности, что comcntr.dll (обычно x64)

• Права пользователя ИБ на внешнее соединение и чтение нужных данных

Установка через ИИ-агента

Если MCP ставит Cursor/Claude/другой агент — дай ему файл AGENTS.md (пошаговый playbook: вопросы к пользователю, COM, Python, mcp.json, smoke-тест, чеклист).

Короткий промпт:

Установи MCP https://github.com/DmitrySkrypkin/mcp-1c-com по инструкции AGENTS.md
в мой проект <путь>. База: Srvr="..."; Ref="..."; пользователь ...; пароль ...

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

1. Клонировать и поставить зависимости

git clone https://github.com/DmitrySkrypkin/mcp-1c-com.git
cd mcp-1c-com

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. Зарегистрировать COM (один раз, от администратора)

regsvr32 "C:\Program Files\1cv8\8.3.<build>\bin\comcntr.dll"

3. Проверить соединение

$env:ONEC_SRVR = "localhost"
$env:ONEC_REF  = "UPP"
$env:ONEC_USR  = "User"
$env:ONEC_PWD  = "secret"
python smoke_test.py

4. Подключить к Cursor

В корне вашего проекта создайте .cursor/mcp.json:

{
  "mcpServers": {
    "upp-com": {
      "command": "C:\\path\\to\\mcp-1c-com\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\mcp-1c-com\\server.py"],
      "env": {
        "ONEC_MCP_NAME": "upp-com",
        "ONEC_SRVR": "localhost",
        "ONEC_REF": "UPP",
        "ONEC_USR": "User",
        "ONEC_PWD": "secret"
      }
    }
  }
}

Готовый шаблон на две базы: examples/mcp.json.example.

Перезапустите MCP в Cursor (Settings → MCP → Refresh).

Инсталлятор в другой проект

Скрипт ставит portable Python (если нужно), зависимости, регистрирует COM, пишет .cursor/mcp.json:

cd mcp-1c-com

# Интерактивно
.\Install-Mcp1cCom.ps1 -ProjectPath D:\MyProject -Interactive

# Или сразу параметрами
.\Install-Mcp1cCom.ps1 `
  -ProjectPath D:\MyProject `
  -ServerName ka-com `
  -Srvr localhost `
  -Ref KA `
  -User User `
  -Password 'secret'

Флаги:

Пароли пишутся только в .cursor/mcp.json (его стоит держать в .gitignore).

Переменные окружения

Примеры запросов

Количество элементов номенклатуры:

ВЫБРАТЬ КОЛИЧЕСТВО(Ссылка) КАК Количество
ИЗ Справочник.Номенклатура

С представлением ссылок:

ВЫБРАТЬ ПЕРВЫЕ 20
  Номер,
  Дата,
  ПРЕДСТАВЛЕНИЕ(Контрагент) КАК Контрагент
ИЗ Документ.РеализацияТоваровУслуг
УПОРЯДОЧИТЬ ПО Дата УБЫВ

Архитектура

flowchart LR
  A[Cursor / Claude] -->|MCP stdio| B[server.py]
  B --> C[onec_com.py]
  C -->|V83.COMConnector| D[(ИБ 1С)]

Подробнее: docs/architecture.md.

Безопасность

• Сервер рассчитан на чтение через язык запросов. Не давайте агенту учётку с лишними правами.

• Не коммитьте .cursor/mcp.json с паролями.

• COM открывает полноценный сеанс 1С от имени указанного пользователя — относитесь к этому как к доступу к базе.

Ограничения

• Только Windows (COM).

• Совпадение разрядности Python ↔ comcntr.dll.

• Ссылки в результате запроса приходят как UUID — для читаемых значений используйте ПРЕДСТАВЛЕНИЕ(...).

• Произвольный Выполнить/Вычислить через внешнее соединение недоступен (это ограничение платформы).

Устранение неполадок

Библиотека не зарегистрирована / нет метода Connect
Повторно зарегистрируйте comcntr.dll от администратора.

Класс не зарегистрирован (0x80040154)
Не тот comcntr.dll или другая разрядность Python.

Несколько версий платформы
V83.COMConnector указывает на последнюю зарегистрированную. Выполните regsvr32 для нужной сборки.

Структура репозитория

mcp-1c-com/
├── AGENTS.md              # Playbook для ИИ-агентов (установка)
├── server.py              # MCP stdio (FastMCP)
├── onec_com.py            # COM: запросы и метаданные
├── config.py              # Строка соединения из env
├── smoke_test.py          # Проверка без Cursor
├── Install-Mcp1cCom.ps1   # Инсталлятор в проект
├── requirements.txt
├── examples/
│   └── mcp.json.example
└── docs/
    └── architecture.md

Лицензия

MIT