1C Syntax MCP Server: Когда твой код не превращается в тыкву

На сцену выходит MCP — штука, которая делает так, чтобы твой тимлид наконец-то понял, какой ты умный разработчик.

Акт первый.

В комнате темно, синицы в руках манят журавлей в небах. Светлый ум ищет выход или вход, но вокруг темно, и мертвые с косами...

ИИ:

MCP Server — это, если говорить простым языком, прослойка между твоим AI-ассистентом и базой знаний о синтаксисе 1С. Представьте себе, что вы взяли документацию по 1С, скормили её какому-то алгоритму, и теперь этот алгоритм может ответить на вопросы типа "а что делает эта функция?" или "какие параметры у СтрДлина?".

Я:

Продолжай...

ИИ:

Но подождите, скажете вы, ведь в интернете полно документации! Да, но есть нюанс.

Этот MCP-сервер работает с реальным синтаксисом 1С — тем, который находится внутри установленной платформы, в файлике shcntx_ru.hbk. Это не какая-то абстрактная документация с сайта 1С, которая может быть неактуальной или содержать ошибки копирования из старых версий. Нет, здесь ты получаешь именно то, что платформа 1С знает о сама о себе.

Я:

Ухожу, шаркая ботинками...

Акт второй.

Ставлю омнироутер с целью обрести бесплатный клауд. ИИ нудит над ухом. Свеча догорела, мальчик достругал палочку, Быков дочитал старые газеты в своем выдуманном конце двадцатого века...

ИИ:

2.1. Что умеет этот зверь?

А умеет он немало:

Поиск функций и методов — вводишь "СтрДлина", получаешь все совпадения. Причём работает как на русском, так и на английском (потому что да, есть люди, которые пишут StrLen, и их надо понять и простить).
Получение информации о функции — спрашиваешь "что такое СтрДлина?", получаешь подробный ответ: какие параметры принимает, что возвращает, и даже в каком контексте работает.
Автодополнение — начинаешь писать "Стр", а тебе подсказывают: "СтрДлина, СтрНайти, СтрЗаменить, СтрЧислоСтрок...". Полезно, когда забыл, как называется нужная функция.
Валидация синтаксиса — пишешь СтрДлина("текст"), а сервер тебе говорит: "Всё ок, вызов корректен". Или наоборот: "Бро, у тебя скобка лишняя" (да, я тоже так умею).

Я:

Чорд, ну не можешь ты без этих 1, 2, 3, 5, 100500... Прям глаз режет. И каким местом МСР скажет тебе про лишнюю скобку? Сходи проспись...

ИИ, не обращая на меня ни малейшего внимания, продолжает нудеть:

3. Как это работает?

Теперь самое интересное — как эту штуку запустить и заставить работать. Сразу предупреждаю: здесь придётся немного поработать руками. Никакой тебе магии "нажал кнопку — получи результат". Но, может, это и к лучшему — ценишь то, что получил.

Я смирившись с пунктами меню:

И нафига ты мне нужен-то, чтобы пальчиками и без магии. Давай, бро, сам начал - сам расхлебывай.

ИИ, заставляя меня зевать, выдает базу:

3.1. Установка

Шаг 1: Python

Да, вам понадобится Python. Не пугайтесь, это не так страшно, как кажется. Скачайте, установите, желательно версию 3.10 или выше. На всякий случай.

Шаг 2: Виртуальное окружение

Создаём виртуальное окружение, чтобы не засрать систему всякими зависимостями:

cd 1c-syntax-mcp
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

Я, офигевая:

"Засрать"? Серьезно?

Пипл, честно, я тут ни при чем.

ИИ:

Шаг 3: Зависимости

Устанавливаем библиотеку MCP:

pip install mcp

Шаг 4: 7-zip

О, а вот это важно! Серверу нужен 7-zip для распаковки файла документации. Без него — никуда.

Я:

Это когда-нить кончится?

Акт  третий.

В концах туннелей забрезжил свет, полная Луна клонится к закату вместе с ракетой, в которой сломался унитаз. Я вообще не понимаю, как можно пиариться без сломанных унитазов. Вы понимаете? Вот и ИИ тоже не понимает. А то "все засрешь".

ИИ:

3.2. Настройка OpenCode

Теперь самое интересное — подключаем это всё к OpenCode. Открываем конфиг (%APPDATA%\opencode\opencode.jsonc на Windows или ~/.config/opencode/opencode.jsonc на Linux) и добавляем:

#WIN
{
  "mcp": {
    "1c-syntax": {
      "type": "local",
      "command": ["C:\\Users\\<username>\\1c-syntax-mcp\\venv\\Scripts\\python.exe", "C:\\Users\\<username>\\1c-syntax-mcp\\server.py"],
      "enabled": true
    }
  }
}
#LIN
{
  "mcp": {
    "1c-syntax": {
      "type": "local",
      "command": ["~/1c-syntax-mcp/venv/bin/python", "~/1c-syntax-mcp/server.py"],
      "enabled": true
    }
  }
}

Я: 

Ну вот, и у ИИ сломался унитаз. Конфиг опенкода лежит в папке юзера, а не аппдаты. Для линуха конфиг верный, для венды - кривой.

ИИ:

3.3. Первый запуск — магия автоматической инициализации

Вот здесь я должен сказать спасибо разработчику. При первом запуске сервер сам:

Находит установленную версию 1С (8.3.x или 8.5.x)
Извлекает файл shcntx_ru.hbk с документацией
Распаковывает его (это около 52 000 файлов, не пугайтесь)
Парсит HTMLки и строит JSON-индекс
Запускается с готовым индексом
Всё это занимает 1-2 минуты при первом запуске. При последующих — 1-2 секунды, потому что индекс уже есть.

Я:

А еще он сам находит 7z. Но это так - мелочи.

ИИ:

4. Использование

Теперь, когда всё настроено, можно использовать. Вот несколько примеров:

Поиск функций:

use 1c-syntax to search for СтрДлина

Информация о функции:

use 1c-syntax to get info about СтрДлина

Я:

Ну ни один дурак так это юзать не будет. Хотя я в этом не уверен на 100%...

ИИ:

5. Навык 1С (1cskills)

Отдельное внимание заслуживает навык 1cskills — набор правил и рекомендаций для AI-ассистентов при работе с кодом на 1С. Это что-то вроде "правил хорошего тона" для AI.

Навык включает:

Обязательный алгоритм проверки синтаксиса через MCP
Контекст выполнения и директивы (&НаКлиенте, &НаСервере и т.д.)
Структуру областей для модулей объектов, менеджеров, форм
Структуру файлов проекта (XML-дамп)
БСП и типовые паттерны
Именование переменных, документирование кода
Язык запросов 1С
И даже регулярные выражения!

Я:

Как же любит он эти свои циферки - прям ваще...

И, что важно, сервер доступен на гите: 1c-syntax-mcp, лицуха MIT.

Если сможете воспользоваться - флаг вам в руки!

Занавес...

На сцену выходит сам автор, честно признается, что сделал это все халявный клауд, и что автор теперь прям вот эксерд по всем этим МСР.

***

КАК ОНО НА САМОМ ДЕЛЕ...

Если серьезно, то код стал сильно лучше. Но давайте сравним:

Вот пример без MCP:

Видим, что система полезла в интернеты и нашла там какую-то дичь.

// Проверка совпадения
Шаблон = Новый ШаблонРегулярногоВыражения("\d{2}\.\d{2}\.\d{4}");
Сообщить(Шаблон.Совпадает("15.01.2024")); // Истина

// Поиск всех совпадений
Шаблон = Новый ШаблонРегулярногоВыражения("\d+");
Результат = Шаблон.НайтиСовпадения("Цена: 100 руб, скидка 20 руб");
Для Каждого Совпадение Из Результат Цикл
    Сообщить(Совпадение.Значение); // 100, 20
КонецЦикла;

// Замена
Шаблон = Новый ШаблонРегулярногоВыражения("\s+");
Результат = Шаблон.Заменить("  много   пробелов  ", " ");
Сообщить(Результат); // " много пробелов "

// С группами захвата
Шаблон = Новый ШаблонРегулярногоВыражения("(\d{4})-(\d{2})-(\d{2})");
Совпадение = Шаблон.НайтиСовпадение("2024-01-15");
Если Совпадение <> Неопределено Тогда
    Сообщить(Совпадение.Группа(1).Значение); // 2024
    Сообщить(Совпадение.Группа(2).Значение); // 01
КонецЕсли;
///
// Email
RegExp = Новый COMОбъект("VBScript.RegExp");
RegExp.Pattern = "[\w.-]+@[\w.-]+\.\w+";
RegExp.Global = Истина;
RegExp.IgnoreCase = Истина;

Matches = RegExp.Execute("Пишите на test@example.com или admin@mail.ru");
Для Сч = 0 По Matches.Count - 1 Цикл
    Сообщить(Matches.Item(Сч).Value);
КонецЦикла;

// Замена
RegExp.Pattern = "\s+";
Сообщить(RegExp.Replace("  много   пробелов  ", " "));
///
// Телефон +7 (999) 123-45-67
Шаблон = Новый ШаблонРегулярногоВыражения("\+7\s?\(?\d{3}\)?\s?\d{3}-?\d{2}-?\d{2}");

// ИНН (10 или 12 цифр)
Шаблон = Новый ШаблонРегулярногоВыражения("^\d{10}$|^\d{12}$");

// СНИЛС
Шаблон = Новый ШаблонРегулярногоВыражения("\d{3}-\d{3}-\d{3}\s?\d{2}");

// Извлечь числа из строки
Шаблон = Новый ШаблонРегулярногоВыражения("-?\d+\.?\d*");

// Проверка URL
Шаблон = Новый ШаблонРегулярногоВыражения("https?://[\w\-\./?=&%]+");

// Разбить по разделителю (запятая/точка с запятой)
Шаблон = Новый ШаблонРегулярногоВыражения("[,;]\s*");
Массив = Шаблон.Разделить("яблоко, груша; банан, апельсин");

// Многострочный режим
Шаблон = Новый ШаблонРегулярногоВыражения("^Строка\d+$", РежимРегулярногоВыражения.Многострочный);

С МСР, но без скилла:

// Создание объекта регулярного выражения
Regex = Новый COMОбъект("System.Text.RegularExpressions.Regex");

// Пример 1: Проверка соответствия строки шаблону (IsMatch)
Строка = "Привет, мир!";
Шаблон = "мир";
Если Regex.IsMatch(Строка, Шаблон) Тогда
    Сообщить("Совпадение найдено");
КонецЕсли;

// Пример 2: Извлечение всех совпадений (Matches)
Строка = "ivanov@example.com, petrov@test.ru, sidorov@mail.com";
Шаблон = "[a-z]+@[a-z]+\.[a-z]+";
Совпадения = Regex.Matches(Строка, Шаблон);
Для Каждого Совпадение Из Совпадения Цикл
    Сообщить(Совпадение.Value); // ivanov@example.com, petrov@test.ru, sidorov@mail.com
КонецЦикла;

// Пример 3: Замена по шаблону (Replace)
Строка = "Цена: 100 руб, Скидка: 50 руб";
Шаблон = "\d+";
Результат = Regex.Replace(Строка, Шаблон, "***");
// Результат: "Цена: *** руб, Скидка: *** руб"

// Пример 4: Разделение строки по шаблону (Split)
Строка = "яблоко, груша; апельсин|мандарин";
Шаблон = "[,;|]";
Массив = Regex.Split(Строка, Шаблон);
Для Каждого Элемент Из Массив Цикл
    Сообщить(СтрЗаменить(Элемент, " ", ""));
КонецЦикла;

// Пример 5: Проверка email
Функция ПроверитьEmail(Email)
    Шаблон = "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$";
    Возврат Regex.IsMatch(Email, Шаблон);
КонецФункции

// Пример 6: Проверка телефона
Функция ПроверитьТелефон(Телефон)
    Шаблон = "^\+7\s?\(?[0-9]{3}\)?\s?[0-9]{3}-?[0-9]{2}-?[0-9]{2}$";
    Возврат Regex.IsMatch(Телефон, Шаблон);
КонецФункции

// Пример 7: Извлечение чисел из строки
Функция ИзвлечьЧисла(Строка)
    Шаблон = "\d+";
    Совпадения = Regex.Matches(Строка, Шаблон);
    МассивЧисел = Новый Массив;
    Для Каждого Совпадение Из Совпадения Цикл
        МассивЧисел.Добавить(Число(Совпадение.Value));
    КонецЦикла;
    Возврат МассивЧисел;
КонецФункции

// Пример 8: Извлечение дат в формате ДД.ММ.ГГГГ
Функция ИзвлечьДаты(Строка)
    Шаблон = "\d{2}\.\d{2}\.\d{4}";
    Возврат Regex.Matches(Строка, Шаблон);
КонецФункции

// Пример 9: Удаление HTML-тегов
Функция УдалитьHTMLТеги(Строка)
    Шаблон = "<[^>]+>";
    Возврат Regex.Replace(Строка, Шаблон, "");
КонецФункции

Суть в том, что он просто не нашел функции, хотя честно попытался искать по "Регулярное", "RegEx" и даже "Стр".

С МСР и скиллом:

// Поиск всех email в тексте
Текст = "Пишите на test@mail.ru или support@example.com";
Результаты = СтрНайтиВсеПоРегулярномуВыражению(Текст, "[\w.]+@[\w.]+\.\w+");

Для Каждого Результат Из Результаты Цикл
	Сообщить(Результат.Значение);
КонецЦикла;
// test@mail.ru
// support@example.com
///
// Удаление всех цифр из строки
Текст = "Товар123 Артикул456";
Результат = СтрЗаменитьПоРегулярномуВыражению(Текст, "\d+", "");
// "Товар Артикул"
///
// Парсинг даты ДД.ММ.ГГГГ
Текст = "Дата: 25.12.2024 и 01.01.2025";
Результаты = СтрНайтиВсеПоРегулярномуВыражению(Текст, "(\d{2})\.(\d{2})\.(\d{4})");

Для Каждого Результат Из Результаты Цикл
	День = Результат.Группы[0].Значение;
	Месяц = Результат.Группы[1].Значение;
	Год = Результат.Группы[2].Значение;
	Сообщить(День + "." + Месяц + "." + Год);
КонецЦикла;
// 25.12.2024
// 01.01.2025
///
// Извлечение телефона из текста
Текст = "Звоните: +7(999)123-45-67";
Результаты = СтрНайтиВсеПоРегулярномуВыражению(Текст, "\+(\d)\((\d{3})\)(\d{3})-(\d{2})-(\d{2})");

Если Результаты.Количество() > 0 Тогда
	Результат = Результаты[0];
	КодСтраны = Результат.Группы[0].Значение;  // 7
	КодОператора = Результат.Группы[1].Значение; // 999
	Номер = Результат.Группы[2].Значение + Результат.Группы[3].Значение + Результат.Группы[4].Значение;
КонецЕсли;
///
// С игнорированием регистра
Текст = "Hello WORLD hello";
Результаты = СтрНайтиВсеПоРегулярномуВыражению(Текст, "hello", Истина);
// Найдёт "Hello" и "hello"

// Многострочный поиск
Текст = "Первая строка
|Вторая строка";
Результаты = СтрНайтиВсеПоРегулярномуВыражению(Текст, "^Вторая", Ложь, Истина);
// Найдёт "Вторая" в начале второй строки
///
// Проверка формата ИНН (10 или 12 цифр)
Функция ПроверитьИНН(ИНН)
	Результаты = СтрНайтиВсеПоРегулярномуВыражению(ИНН, "^\d{10}$|^\d{12}$");
	Возврат Результаты.Количество() > 0;
КонецФункции

// Извлечение чисел из строки
Функция ПолучитьЧислаИзСтроки(Текст)
	Результаты = СтрНайтиВсеПоРегулярномуВыражению(Текст, "\d+");
	Числа = Новый Массив;
	Для Каждого Результат Из Результаты Цикл
		Числа.Добавить(Число(Результат.Значение));
	КонецЦикла;
	Возврат Числа;
КонецФункции

// Удаление лишних пробелов
Функция НормализоватьПробелы(Текст)
	Возврат СтрЗаменитьПоРегулярномуВыражению(Текст, "\s+", " ");
КонецФункции

// Проверка email
Функция ЭтоEmail(Email)
	Результаты = СтрНайтиВсеПоРегулярномуВыражению(Email, "^[\w.+-]+@[\w-]+\.[\w.]+$");
	Возврат Результаты.Количество() > 0;
КонецФункции

А вот если ты написал скилл так, чтобы ИИ шел в МСР и внимательнейшим образом относился к синтаксису, проверяя каждый чих, можешь получить рабочий код даже на бесплатной модели.

В заключении...

Мир меняется. Он меняется уже давно, но вайбкодинг сейчас вошел в некий раж. Разобраться с этим архиважно и архинужно. Самое важное - это понять, что для хорошего кода нужен хороший промпт, а он складывается из хорошо описанного скилла и имеющегося в наличии МСР и понятного запроса, который не нужно додумывать. Все проблемы ИИ в том, что пользователь заставляет его додумывать, а не руководствоваться четкой и понятной программой действий. Так что: хороший скилл -> МСР -> хороший запрос = правильный код.

Я попросил ИИ переписать это все на серверные рельсы, будем в конторе раскатывать.

ЗЫ: Я честно пытался написать эту статью с помощью ИИ, но он это делает так себе.

ЗЫЗЫ: Выше ссылка на ГИТ. Все, что вы там увидите, сделано разными моделями в опенкоде. Включая создание репы и MR туда.

Новый светлый мир. И с этим придется разобраться.

Каналы, лайки, звездочки в гитах, чтотамеще - приветствуется!