1c-templates-mcp

MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor

  • 31 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • Инструменты MCP добавляют, обновляют и удаляют шаблоны в базе SQLite
  • MCP-эндпоинт и веб-интерфейс открыты без авторизации на выбранном порту
  • Эмбеддинги можно считать через внешний OpenAI-совместимый API
Все причины и проверки
Российский стек

desko77/1c-templates-mcp

Установка

Ручная установка

cd deploy && docker compose up -d

Установка из готового образа Docker Hub desko77/1c-templates-mcp, рекомендуемый способ.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Инструменты MCP добавляют, обновляют и удаляют шаблоны в базе SQLite
  • MCP-эндпоинт и веб-интерфейс открыты без авторизации на выбранном порту
  • Эмбеддинги можно считать через внешний OpenAI-совместимый API

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер хранит базу готовых шаблонов кода 1С (более 2200 штук из сообщества) и дает агенту шесть MCP-инструментов: гибридный семантический и полнотекстовый поиск, список с пагинацией, получение шаблона по id, добавление, обновление и удаление. Данные хранятся в SQLite как источнике истины и индексируются в ChromaDB для векторного поиска, embeddings можно брать через OpenAI-совместимый API (LM Studio, Ollama) или считать локально моделью SentenceTransformer с автоматическим откатом при недоступности API. Есть полноценный веб-интерфейс для правки шаблонов с подсветкой BSL через Monaco Editor. Отдельно в docs/rules лежит объемный companion-справочник по API 1С:ЗУП 3.1, который можно подключить агенту как дополнительный контекст.

Для кого. Для 1С-разработчиков, которые хотят переиспользовать проверенные шаблоны кода через агента и находить их по смыслу запроса, а не по точному названию.

Подходит, если

  • Нужна большая готовая база шаблонов BSL для типовых задач, а не пустая коллекция
  • Хотите искать шаблон по смыслу вопроса на русском языке
  • Работаете с 1С:ЗУП и хотите подключить агенту companion-справочник по кадровому API

Не подходит, если

  • Не хотите поднимать Docker-стек с ChromaDB и embedding-моделью
  • Достаточно точного поиска по названию без семантики
  • Нужно изменение шаблона напрямую в базе без последующего экспорта в seed_templates.jsonl: без этого шага правки теряются при пересборке

Пример запроса к агенту

Найди шаблон для расчета среднего заработка в ЗУП и покажи код с описанием

MCP

Транспорт
http
Авторизация
не нужна

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

EMBEDDING_PROVIDER
Провайдер embeddings: auto, local или openai.
OPENAI_API_BASE
URL OpenAI-совместимого API для embeddings, например локального LM Studio.
OPENAI_API_KEY секрет
Ключ для OpenAI-совместимого API, не нужен для локального LM Studio по умолчанию.

Ограничения

Проект без лицензии в репозитории. Правки через веб-интерфейс живут только в runtime-БД Docker volume и теряются при docker compose up --build или удалении volume, если их заранее не выгрузить в seed_templates.jsonl. Модель RoSBERTa для лучшего качества на русском требует GPU или 5-10 минут индексации на CPU. GPU-профиль требует установленного nvidia-container-toolkit.

Как отключить. Остановите контейнер командой docker compose down и удалите сервер из конфигурации MCP клиента.

Частые вопросы

Нужен ли внешний сервис эмбеддингов?

Нет, по умолчанию режим auto пробует OpenAI-совместимый API, а при его недоступности откатывается на локальную модель.

Как не потерять шаблон, добавленный через веб-интерфейс?

Выгрузить runtime-БД в seed_templates.jsonl скриптом export_to_jsonl.py до пересборки образа или удаления volume.

Чем 1c-templates-mcp отличается от поиска шаблонов кода 1С по сайтам?

Сервер хранит базу из более 2200 шаблонов BSL от сообщества и дает агенту шесть MCP-инструментов: гибридный семантический и полнотекстовый поиск, список с пагинацией, получение шаблона. Есть CRUD-интерфейс на Monaco Editor.

Как запустить 1c-templates-mcp и как не потерять добавленные шаблоны?

Запуск в Docker: cd deploy && docker compose up -d. Шаблоны, добавленные через веб-интерфейс, хранятся в томе Docker, не удаляйте его и делайте копию. Подключается к Claude Code и Cursor.

Обсуждение

Вопросов и отзывов пока нет.

MCP-сервер шаблонов 1С

MCP сервер шаблонов 1С

Российский стек

MCP-сервер для хранения и поиска своих шаблонов кода BSL с веб-редактором и подсветкой синтаксиса

MCP-серверРасширенный доступ18Звезды репозитория
Российский стек

MCP-сервер для Cursor и Claude Desktop с гибридным поиском embeddings и BM25 по справке платформы 1С, языку запросов и Библиотеке стандартных подсистем

MCP-серверРасширенный доступ7Звезды репозитория
Российский стек

MCP-сервер на Go одним бинарником: агент видит метаданные базы 1С, ищет по коду, выполняет запросы на чтение и пишет точный BSL

MCP-серверШирокий доступ255Звезды репозитория
Российский стек

Read-only MCP-сервис гибридного поиска по коду 1С BSL: BM25 плюс векторный поиск, дедупликация и reranking

MCP-серверРасширенный доступ3Звезды репозитория
Российский стек

MCP-сервер строит граф метаданных и вызовов по XML- и BSL-выгрузке конфигурации 1С, с опциональным семантическим поиском через внешний эмбеддер и Qdrant

MCP-серверРасширенный доступ4Звезды репозитория
Российский стек

MCP-сервер поиска по синтакс-помощнику платформы 1С: глобальные функции, методы и свойства объектов через Elasticsearch

MCP-серверРасширенный доступ76Звезды репозитория

Коротко о README

README описывает установку из готового Docker-образа или сборкой из исходников с профилями cpu и gpu, таблицу шести MCP-инструментов, маршруты веб-интерфейса, полный список переменных конфигурации, архитектурную схему (FastAPI, SQLite, ChromaDB, embeddings), три режима выбора провайдера embeddings, процесс добавления шаблона через JSONL или веб-интерфейс с предупреждением о потере данных, и отдельный раздел про companion-справочник по 1С:ЗУП с инструкцией подключения к Claude Code и Cursor.

Бейдж для README

Сообщить о проблеме