1c-templates-mcp
MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Работает только с локальной базой шаблонов, не подключается к рабочей базе 1С
- MCP-эндпоинт и веб-интерфейс открыты без авторизации на выбранном порту
Установка
Ручная установка
cd deploy && docker compose up -dУстановка из готового образа Docker Hub desko77/1c-templates-mcp, рекомендуемый способ.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер хранит базу готовых шаблонов кода 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: без этого шага правки теряются при пересборке
Пример запроса к агенту
Найди шаблон для расчета среднего заработка в ЗУП и покажи код с описаниемОграничения
Проект без лицензии в репозитории. Правки через веб-интерфейс живут только в runtime-БД Docker volume и теряются при docker compose up --build или удалении volume, если их заранее не выгрузить в seed_templates.jsonl. Модель RoSBERTa для лучшего качества на русском требует GPU или 5-10 минут индексации на CPU. GPU-профиль требует установленного nvidia-container-toolkit.
Как отключить. Остановите контейнер командой docker compose down и удалите сервер из конфигурации MCP клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| EMBEDDING_PROVIDER | Провайдер embeddings: auto, local или openai. |
| OPENAI_API_BASE | URL OpenAI-совместимого API для embeddings, например локального LM Studio. |
| OPENAI_API_KEY секрет | Ключ для OpenAI-совместимого API, не нужен для локального LM Studio по умолчанию. |
Проверка безопасности
- Работает только с локальной базой шаблонов, не подключается к рабочей базе 1С
- MCP-эндпоинт и веб-интерфейс открыты без авторизации на выбранном порту
Коротко о README
README описывает установку из готового Docker-образа или сборкой из исходников с профилями cpu и gpu, таблицу шести MCP-инструментов, маршруты веб-интерфейса, полный список переменных конфигурации, архитектурную схему (FastAPI, SQLite, ChromaDB, embeddings), три режима выбора провайдера embeddings, процесс добавления шаблона через JSONL или веб-интерфейс с предупреждением о потере данных, и отдельный раздел про companion-справочник по 1С:ЗУП с инструкцией подключения к Claude Code и Cursor.
Частые вопросы
Нужен ли внешний сервис эмбеддингов?
Нет, по умолчанию режим auto пробует OpenAI-совместимый API, а при его недоступности откатывается на локальную модель.
Как не потерять шаблон, добавленный через веб-интерфейс?
Выгрузить runtime-БД в seed_templates.jsonl скриптом export_to_jsonl.py до пересборки образа или удаления volume.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything