1C Templates Server

MCP-сервер для хранения и поиска шаблонов BSL-кода. Управление шаблонами — через веб-интерфейс с BSL Console (подсветка синтаксиса 1С).

Запуск

run.bat

Скрипт собирает Docker-образ и запускает контейнер с маппингом data/templates/ на хост.

Или вручную:

docker build -t mcp-templates .
docker run -d --name mcp-templates -p 8023:8023 \
  -v "$(pwd)/data/templates:/app/data/templates" \
  -e TEMPLATES_DIR=/app/data/templates \
  --restart unless-stopped mcp-templates

Веб-интерфейс

Откройте в браузере: http://localhost:8023

• Список шаблонов с поиском (по названию, описанию, тегам)
• Создание и редактирование шаблонов в BSL Console (подсветка синтаксиса 1С)
• Удаление шаблонов

Подключение в Cursor / Claude Code

Сервер использует транспорт Streamable HTTP. В настройках MCP укажите:

{
  "mcpServers": {
    "1c-templates": {
      "type": "streamableHttp",
      "url": "http://localhost:8023/mcp"
    }
  }
}

MCP-инструменты

Инструмент	Описание
list_templates()	Список всех шаблонов (id, name, description, tags)
get_template(template_id)	Полный шаблон с кодом по id
search_templates(query)	Поиск по подстроке в названии, описании и тегах

Поиск нечёткий: регистр и ё/е игнорируются, для слов длиннее 4 символов работает префиксный поиск (находит падежи).

Пример использования в Cursor

В чате напишите:

Найди шаблон для работы с Excel и вставь код в текущий модуль

Cursor через MCP вызовет search_templates("excel"), получит id шаблона, затем get_template(id) — и вернёт BSL-код.

Хранилище шаблонов

Шаблоны хранятся в data/templates/ (Docker volume, данные сохраняются при пересборке):

• index.json — метаданные всех шаблонов (id, name, description, tags)
• <id>.bsl — BSL-код каждого шаблона

Добавление шаблона вручную

Создайте файл data/templates/my_template.bsl с кодом, а в index.json добавьте запись:

{
  "my_template": {
    "id": "my_template",
    "name": "Мой шаблон",
    "description": "Описание",
    "tags": ["тег1", "тег2"]
  }
}

Новые .bsl-файлы без записи в index.json подхватываются автоматически при следующем обращении к списку.

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

.
├── Dockerfile
├── run.bat              # Сборка и запуск контейнера
├── app/
│   ├── main.py          # HTTP-сервер + MCP (stdlib Python, без зависимостей)
│   └── storage.py       # CRUD: index.json + .bsl файлы
└── data/
    └── templates/       # Шаблоны (volume, ~30 шаблонов в комплекте)
        ├── index.json
        └── *.bsl

Сервер написан на чистом stdlib Python — никакого pip, виртуальных окружений или сторонних пакетов.