MCP-сервер метаданных 1С
1C_MCP_metadata
MCP-сервер поверх HTTP-сервиса расширения 1С: отдает структуру метаданных конфигурации, ищет объекты и проверяет синтаксис запросов
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструменты только читают структуру метаданных и проверяют синтаксис запроса, записи в базу нет
- HTTP-сервис публикуется в сети без описанной аутентификации, стоит ограничить доступ на уровне публикации
Установка
Ручная установка
{
"mcpServers": {
"1c-metadata": {
"command": "powershell",
"args": [
"-ExecutionPolicy", "Bypass",
"-NoProfile",
"-WindowStyle", "Hidden",
"-File",
"C:\\mcp-1c\\mcp-1c-powershell.ps1",
"-BaseUrl",
"http://localhost/kirill/hs/mcpmetadata"
]
}
}
}Пример из README, путь и -BaseUrl нужно заменить на свои.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект состоит из расширения 1С с HTTP-сервисом MCPmeta_MCPСервис и PowerShell-скрипта, который оборачивает вызовы этого сервиса в протокол MCP по stdio. Агент получает структуру метаданных конфигурации с фильтром по типу объектов, детальную информацию по конкретному объекту, поиск объектов по имени, синониму и комментарию среди справочников, документов, регистров, отчетов, обработок и других типов, а также проверку синтаксиса запроса на языке запросов 1С с описанием ошибки. Режим SSE в проекте не реализован из-за технических сложностей, поэтому связь идет через stdio-обертку.
Для кого. Для 1С-разработчиков, которым нужно быстро давать ИИ-агенту структуру метаданных конкретной конфигурации без ручного экспорта.
Подходит, если
- Нужно, чтобы агент искал объекты метаданных по имени или синониму прямо в живой базе
- Нужна проверка синтаксиса сгенерированного агентом запроса перед выполнением
- Нужна детальная структура конкретного справочника, документа или регистра
Не подходит, если
- Нужен транспорт SSE или сетевой HTTP без PowerShell: в текущем виде это не реализовано
- Путь к скрипту содержит кириллицу: README прямо просит ее избегать
Пример запроса к агенту
Найди в метаданных все объекты, связанные со словом Номенклатура, и покажи структуру справочника НоменклатураОграничения
Больше года без пушей, лицензия не указана. Нужно вручную установить расширение в конфигурацию и опубликовать HTTP-сервис MCPmeta_MCPСервис, а мост к MCP работает только через PowerShell-скрипт на stdio. README ничего не говорит о правах доступа и аутентификации HTTP-сервиса.
Как отключить. Удалите сервер из конфигурации MCP клиента, отключите расширение MCPmeta в базе 1С и снимите публикацию HTTP-сервиса.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Проверка безопасности
- Инструменты только читают структуру метаданных и проверяют синтаксис запроса, записи в базу нет
- HTTP-сервис публикуется в сети без описанной аутентификации, стоит ограничить доступ на уровне публикации
Коротко о README
README описывает реализацию MCP-сервера для 1С:Предприятия с расширением, публикующим HTTP-сервис, и PowerShell-скриптом для stdio-режима. Перечислены четыре инструмента: получение структуры метаданных, детальной информации об объекте, поиск объектов и валидация запроса. Дан пример конфигурации mcpServers с командой powershell и параметрами -BaseUrl.
Частые вопросы
Почему используется PowerShell, а не прямой HTTP или SSE?
Автор указывает, что реализовать SSE в текущем виде проблематично, поэтому мостом к stdio служит PowerShell-скрипт, вызывающий HTTP-методы расширения.
Какие типы объектов метаданных поддерживаются?
Справочники, документы, регистры сведений и накопления, отчеты, обработки, планы видов характеристик, планы счетов, планы обмена, бизнес-процессы и задачи.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything