Mcp 1c

by feenlace

561 downloads

Not rated

GitHub

About

MCP server for 1C:Enterprise. Metadata inspection, BSL code search, query execution, event log, syntax reference. One Go binary, zero dependencies.

Details

Author: feenlace
Downloads: 561
Categories: Database, Other, Developer Tools

- One binary, zero dependencies (written in Go).
- 9 tools for live 1C database work.
- Full-text search (smart BM25, regex, exact) with BSL synonym support.
- Sharded indexing (~7 sec for 13,000+ modules) with disk cache.
- Non‑blocking start – server is available immediately.
- Works with any MCP‑compatible client and any AI model.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Mcp 1c

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

From the repository

Download the binary for your OS from Releases. Run mcp-1c --install "path-to-base" to automatically set up the required extension in your 1C database. Then start the 1C HTTP service (recommended via Apache/IIS, or use /HTTPPort for quick testing on Windows). Finally, configure your AI client with a JSON block specifying the command and arguments (e.g., --base http://localhost:8080/hs/mcp). The server exposes nine tools for the free version, with fifteen additional tools available in the paid beta.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp 1c": {
            "1c": {
                "command": "mcp-1c",
                "args": [
                    "--base",
                    "http://localhost:8080/hs/mcp"
                ]
            }
        }
    }
}

McpServers

{
    "1c": {
        "command": "mcp-1c",
        "args": [
            "--base",
            "http://localhost:8080/hs/mcp"
        ]
    }
}

MCP-сервер для интеграции AI-ассистентов с 1С:Предприятие

AI видит метаданные вашей конфигурации 1С и генерирует точный код на BSL. Работает с любым MCP-совместимым клиентом.

MCP-1C не привязан к конкретной нейросети. Работает с любым MCP-совместимым клиентом:

- Локальные модели(Ollama, LM Studio, llama.cpp) - данные не покидают вашу сеть
- Облачные сервисы(Claude, GPT, YandexGPT, GigaChat) - через соответствующие MCP-клиенты
- IDE с AI(Cursor, VS Code + Continue/Cline, JetBrains)

Ваш код и данные 1С остаются у вас. MCP-1C - это локальный процесс, который общается только с вашей базой.

Помимо бесплатной Открытой версии, доступны платные редакции с расширенными возможностями:

- Расширенная(1 990 ₽/мес). Восемь консолидированных инструментов (модель с параметромaction): чтение исходного кода модулей, работа со схемами XSD и проверка XML, оптимизатор запросов, линтер BSL, синтакс-помощник, мультибазовость, расширения .cfe, песочница кода, память проекта и шаблоны
- Профессиональная(4 990 ₽/мес). Всё из Расширенной, плюс глубокий анализ всей кодовой базы, навигация по коду и граф зависимостей, семантический поиск, архитектурная визуализация, автодокументация, генерация тестов и .epf-обработок, навигация по типовым конфигурациям, сравнение базы и расширений, проверка запросов и API платформы, разбор прав RLS и планов обмена

При регистрации вы получаете 14 дней Профессиональной версии бесплатно.

[!TIP]Бета-тест Профессиональной версии.Мы запустили Профессиональную редакцию для глубокого анализа всей кодовой базы: массовый анализ (антипаттерны, дубли, мёртвый код, аудит безопасности, метрики качества), навигация по коду и граф зависимостей, семантический поиск, архитектурная визуализация, автодокументация, генерация тестов (YAxUnit, Vanessa-Automation) и .epf-обработок, навигация по типовым конфигурациям, сравнение базы и расширений, проверка запросов и API платформы, разбор прав RLS и планов обмена.

Зарегистрируйтесь и получите 14 дней бесплатно. Активным бета-тестерам, которые делятся полезной обратной связью и хотят продолжить тестирование, продлеваем пробный период. Топ-5 бета-тестеров получат бесплатную подписку навсегда на Профессиональную версию.

→Зарегистрироваться|Документация Pro|Сообщить о проблеме

Расширенная добавляет (8 консолидированных инструментов):

- Чтение исходного кода модулей: объекты, формы, общие модули, расширения
- Сжатый контекст метаданных и резолв имён объектов по индексу выгрузки
- Работа со схемами XSD и структурная проверка XML по реальной выгрузке
- Оптимизатор запросов (15 антипаттернов) и линтер BSL (30+ диагностик)
- Синтакс-помощник (10 000+ определений) и проверка совместимости версий
- Генераторы запросов и печатных форм, конвертер модальных вызовов в асинхронные
- Песочница кода с подтверждением и аудит-логом
- Мультибазовость и работа с расширениями .cfe (чтение, поиск)
- Память проекта (memory) и библиотека шаблонов кода (templates)
- Работа через реверс-опрос (long polling): фоновое регламентное задание в 1С само опрашивает сервер, публиковать HTTP-сервис на веб-сервере не нужно

- Массовый анализ всей кодовой базы (bulk_analyze): антипаттерны, дубли, мёртвый код, аудит безопасности BSL, метрики качества, тренды
- Семантический поиск по коду (LSA + Randomized SVD) и гибридный режим
- Навигация по коду и граф зависимостей: иерархия вызовов, переход к объявлению, поиск мест вызова, анализ архитектурных границ, структурные запросы к графу
- Досье объекта и чтение схем компоновки данных (СКД) отчётов
- Архитектурная визуализация (диаграммы) и автогенерация документации
- Генерация тестов (YAxUnit, Vanessa-Automation) и .epf-обработок
- Навигация по типовым конфигурациям (БП, ЗУП, УТ, Розница, КА, ERP)
- Структурный diff расширений .cfe и сверка основной конфигурации с расширением (code_review)
- Помощник по обновлению типовых конфигураций
- Семантическая проверка запросов по метаданным и проверка API платформы в коде BSL
- Разбор прав и RLS ролей, а также планов обмена (офлайн, по выгрузке)
- CI/CD интеграция (--ci, --json, quality gates), отчёты HTML/PDF/SARIF

- Один бинарник, ноль зависимостей.Написан на Go - не нужен Python, Node.js, JVM или EDT. Скачал, запустил, работает.
- 11 инструментов для работы с живой базой.Метаданные, информация о конфигурации, формы, запросы к данным (с параметрами), поиск по коду, перечитывание выгрузки, валидация, журнал регистрации, справка BSL, анализ подсистем.
- Полнотекстовый поиск по коду(search_code). Три режима: smart (BM25-ранжирование), regex, exact. Встроенные BSL-синонимы - поиск поStrFindнаходитСтрНайтии наоборот.
- Шардированная индексация.Параллельная сборка индекса по числу ядер. ~7 сек для 13 000+ модулей. Дисковый кеш - повторный запуск мгновенный.
- Неблокирующий старт.Индекс строится в фоне, MCP-сервер доступен сразу. Поиск заработает после завершения индексации.
- Работает с вашей базой.AI видит реальную конфигурацию и реальные данные - не абстрактную справку, а именно вашу базу.
- Не привязан к IDE и нейросети.Работает с Конфигуратором, EDT, или вообще без IDE. Работает с любой моделью, включая локальные (Ollama, LM Studio). Нужен только HTTP-сервис 1С.
- Автоустановка.mcp-1c --install "C:\путь\к\базе"- сам найдёт платформу, поставит расширение, обновит конфигурацию БД.
- Встроенная справка BSL.Синтаксис функций платформы доступен без внешних сервисов и без запущенной 1С.

Впервые слышите про MCP?Читайте пошаговую инструкцию- там всё с нуля, включая объяснение что такое MCP.

Бинарник для вашей ОС - в Releases. Или:go build -o mcp-1c ./cmd/mcp-1c/

# Windows mcp-1c --install "C:\путь\к\базе" # macOS / Linux mcp-1c --install ~/Documents/InfoBase # Клиент-серверная база (MS SQL, PostgreSQL) mcp-1c --install "srv-1c\buh_prod" --server --db-user Admin --db-password pass

Если платформа установлена в нестандартную папку:mcp-1c --install "путь" --platform "/custom/path/to/1cv8"

Если версия платформы не определяется автоматически (нестандартный путь без номера версии), укажите её явно:mcp-1c --install "путь" --platform "/custom/path/to/1cv8" --platform-version 8.3.13

Этой сборке нужно расширение версии 0.4.7 или новее. Более старое запуску не мешает: сервер работает, но пишет в журналExtension is OLDER than this build requires, и часть инструментов будет отвечать ошибкой.

Опубликуйте HTTP-сервис 1С через Apache или IIS (Конфигуратор → Администрирование → Публикация на веб-сервере). Работает на Windows и Linux. Подробности в пошаговой инструкции.

Конфигурация MCP-сервера одинакова для любого клиента и любой модели. Не важно, используете вы Claude, Ollama или LM Studio, настройка MCP-1C не меняется:

{ "mcpServers": { "1c": { "command": "/path/to/mcp-1c", "args": ["--base", "http://localhost:8080/hs/mcp-1c"] } } }

На Windows пути с обратными слешами:"command": "C:\\путь\\к\\mcp-1c.exe"

Перезапустите AI-клиент. В Claude Desktop рекомендуем:«+» → Connectors → Tool access → Always available.

Также поддерживаются:Claude Code,Cursor,Windsurf,VS Code + Copilot,VS Code + Continue,JetBrains IDE, а также любые клиенты для локальных моделей с поддержкой MCP. Настройка каждого - впошаговой инструкции.

Спросите:«Покажи структуру конфигурации моей базы 1С»

Логин и пароль передавайте флагами--userи--password(или переменнымиMCP_1C_USERиMCP_1C_PASSWORD), а не внутри адреса.Указывайте оба сразу:--userбез--passwordотправляет HTTP Basic с пустым паролем. Записьhttp://Admin:secret@сервер/база/hs/mcp-1cтоже работает, mcp-1c снимает учётные данные с адреса при запуске и в тексты ошибок и журнала они не попадают, но часть таких адресов отклоняется при старте: с?или#, с русскими буквами в логине или пароле, а также с@в пути при явном порте. Полный разбор:Адрес HTTP-сервиса в --base.

Перенаправления mcp-1c выполняет только в пределах адреса из--base: та же схема, тот же хост, тот же порт. Если веб-сервер переадресуетhttpнаhttpsили на другой порт, укажите в--baseконечный адрес.

По умолчанию поведение зависит от того, запущен ли сервер в терминале или через MCP-клиент:

- В терминале(stdin подключён к tty): прогресс индексации, информационные сообщения и ошибки пишутся в stderr как обычно.
- Через MCP-клиент(Kilo Code, OpenCode, Claude Desktop, Cursor и др., когда stdin это pipe): stderr пустой, случайный вывод сторонних библиотек перенаправляется в~/.cache/mcp-1c/stderr.log. Это защищает клиентов, которые трактуют любой stderr-вывод как фатальную ошибку (Issue #14).

Эти оболочки подключают stdin через именованные pipes, а не через обычный console handle. Автодетект считает их не-TTY, поэтому прогресс индексации по умолчанию не выводится. Для ручной диагностики используйте флаг--verboseили полноценныйcmd.exe/ Windows Terminal.

go build -o mcp-1c ./cmd/mcp-1c # сборка go test ./... -v -race # тесты go run ./cmd/mock-1c -port 9191 # mock-сервер 1С

Исходники расширения хранятся вextension/src/в формате XML-выгрузки конфигурации. При--installони встроены в бинарник черезgo:embedи загружаются напрямую через DESIGNER/LoadConfigFromFiles. Готовый .cfe файл для сборки не требуется.

ГотовыйMCP_HTTPService.cfeдоступен в Releases- это самый простой путь установки, если у вас нет доступа к командной строке на сервере 1С (например, при работе через RDP). Подробнее:docs/1c-setup.md.

# macOS / Linux (требуется установленная платформа 1С) ./scripts/build-extension.sh ~/Documents/InfoBase # Windows scripts\build-extension.cmd C:\Users\User\Documents\InfoBase

MCP-1C не знает и не определяет, какая модель работает на стороне клиента. Конфигурация одна и та же.

Минимальная поддерживаемая версия платформы:8.3.10

Сам сервер нетребователен к ресурсам. Тяжёлое железо нужно только если вы поднимаете локальную модель, и эти требования задаёт сама модель, а не MCP-1C.

- Бинарник.Один статичный исполняемый файл без зависимостей (не нужны Python, Node.js, JVM или EDT). Размер порядка 25-40 МБ.
- ОС и архитектуры.Windows, macOS, Linux; amd64 и arm64.
- Платформа 1С.Минимальная поддерживаемая версия 8.3.10. Для ручной установки готового.cfeнужна версия 8.3.14 или выше.
- Доступ к данным.HTTP-сервис 1С или офлайн-выгрузка конфигурации (--dump).
- CPU и RAM.Требования минимальны, фиксированного минимума нет. При построении поискового индекса память ограничена по архитектуре: данные обрабатываются батчами и стримятся на диск.
- Диск.Кеш поискового индекса порядка 100-200 МБ для крупных конфигураций (БСП, ERP, УТ). Сборка занимает порядка 7 секунд на 13 000+ модулей, повторный запуск использует кеш.

MCP-1C не запускает и не размещает никакую модель. Он работает с любой моделью на стороне клиента, поэтому требования к железу для модели зависят от вашего выбора:

- Облачная модель(Claude, GPT, YandexGPT, GigaChat): локальных требований к железу нет.
- Локальная модель(Ollama, LM Studio, llama.cpp): требования к RAM, VRAM и диску задаёт выбранная модель, а не MCP-1C.

- Один бинарник, ноль зависимостей: подключаем AI к вашей базе 1С за 10 минут

Connect SAP Business One (SQL Server) to Claude AI Desktop via MCP. Query financials, inventory, sales, and purchasing with natural language.

A read-only MCP server for querying live Oracle SCM data, powered by the CData JDBC Driver.

A read-only MCP server by CData that enables LLMs to query live data from Sage 300.

A read-only MCP server for SAP BusinessObjects BI, powered by the CData JDBC Driver.

A read-only MCP server by CData that enables LLMs to query live data from Epicor Kinetic.

A read-only MCP server by CData that enables LLMs to query live data from Exact Online.

A read-only MCP server for Intacct, enabling LLMs to query live data using the CData JDBC Driver.

A read-only MCP server for querying live SAP Fieldglass data, powered by the CData JDBC Driver.

Manage Apache Superset datasets, metrics, and SQL queries.

Interact with Teradata databases for data queries and business intelligence.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Mcp 1c

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Redis

Sentry

Github

Filesystem

EverArt