1C MCP Server

MCP-сервер для подключения Claude к 1С:Предприятие через стандартный OData REST API.

Работает с любой конфигурацией 1С, где включён OData: УТ, УНФ, Бухгалтерия, ERP и другие.

Что умеет

Просто пишешь Claude на русском — он сам вызывает нужные инструменты:

Related MCP server: 1C_MCP_SERVER_OWN

Демо

Создание заказа — Claude сам находит контрагента, товар, цену и оформляет заказ:

Проверка остатков — анализирует хватит ли товара на заказ:

Цены — быстрый запрос прайса по всей номенклатуре:

Инструменты

Требования

• Python 3.10+

• 1С:Предприятие 8.3 с включённым OData (HTTP-сервис)

• Claude Desktop

Установка

git clone https://github.com/HRYNdev/1c-mcp.git
cd 1c-mcp
python -m venv .venv
.venv\Scripts\activate        # Windows
# source .venv/bin/activate   # Linux/Mac
pip install -r requirements.txt

Создай .env из шаблона:

copy .env.example .env

Заполни .env:

ONEC_BASE_URL=http://localhost/your_base/odata/standard.odata
ONEC_LOGIN=admin
ONEC_PASSWORD=your_password

Подключение к Claude Desktop

Добавь в claude_desktop_config.json:

{
  "mcpServers": {
    "1c-mcp": {
      "command": "C:\\path\\to\\1c-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\1c-mcp\\server.py"],
      "env": {
        "ONEC_BASE_URL": "http://localhost/your_base/odata/standard.odata",
        "ONEC_LOGIN": "admin",
        "ONEC_PASSWORD": "your_password"
      }
    }
  }
}

Путь к конфигу:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Тестирование без реальной 1С

В репозитории есть mock-сервер, который имитирует 1С OData:

.venv\Scripts\uvicorn mock_server.server:app --port 8181

В .env укажи:

ONEC_BASE_URL=http://localhost:8181/odata/standard.odata
ONEC_LOGIN=admin
ONEC_PASSWORD=admin

Mock содержит тестовые данные: 8 товаров, 3 склада, 4 контрагента, остатки, цены и заказы.

Как включить OData в 1С

1. Открой конфигуратор → Администрирование → Публикация на веб-сервере

2. Включи OData REST-интерфейс

3. Отметь объекты (справочники, документы, регистры), которые нужны

4. Опубликуй на локальном веб-сервере (Apache или IIS)

Структура проекта

1c-mcp/
├── server.py          # MCP сервер (8 инструментов)
├── client.py          # HTTP клиент к 1С OData
├── requirements.txt
├── .env.example
└── mock_server/
    └── server.py      # Mock 1С OData для разработки

Адаптация под вашу конфигурацию

Стандартные имена объектов OData могут отличаться в зависимости от конфигурации:

Нужна адаптация под вашу конфигурацию — пишите в issues.

Часть проекта HomeLab-MCP — коллекции MCP серверов для автоматизации.