MCP-сервер предоставляет инструменты Model Context Protocol для запуска команд расширения 1c-platform-tools через агентов Cursor/VS Code.
Быстрый старт
- Установите расширение 1c-platform-tools и MCP 1C Platform Tools (из VS Code Marketplace или Open VSX).
- Включите IPC: настройка
1c-platform-tools.ipc.enabled = true.
- Откройте проект 1С (папка с
packagedef).
В VS Code MCP регистрируется расширением автоматически: после установки и включения IPC ничего настраивать не нужно.
В Cursor на данный момент не поддерживается API регистрации MCP через расширения, поэтому сервер не появляется в «Installed MCP Servers». Варианты:
- Через каталог MCP (рекомендуется): после публикации сервера в MCP Registry его можно добавить в Cursor из каталога (как другие MCP) — тогда не нужен ручной путь в
mcp.json. Инструкция по публикации в каталог: MCP_REGISTRY_PUBLISH.md.
- Вручную: добавьте сервер в
mcp.json, как описано ниже.
- Создайте или откройте файл конфигурации MCP:
- глобально:
~/.cursor/mcp.json (в Windows: %USERPROFILE%\.cursor\mcp.json);
- в проекте:
.cursor/mcp.json в корне проекта.
- Укажите сервер в формате ниже. В пути к расширению можно использовать переменные окружения: в Cursor в
mcp.json поддерживается подстановка ${env:ИМЯ} (например ${env:USERPROFILE} в Windows или ${env:HOME} в macOS/Linux). Папку расширения можно посмотреть в Cursor: расширения → MCP 1C Platform Tools → правый клик → «Copy Extension Path».
Пример (Windows, путь через домашнюю папку):
{
"mcpServers": {
"mcp-1c-platform-tools": {
"command": "node",
"args": ["${env:USERPROFILE}\\.cursor\\extensions\\yellow-hammer.mcp-1c-platform-tools-0.1.0\\out\\src\\index.js"],
"env": {
"ONEC_IPC_PORT": "порт из 1c-platform-tools.ipc.port",
"ONEC_IPC_TOKEN": "токен из 1c-platform-tools.ipc.token (если задан)"
}
}
}
}
macOS/Linux: замените путь на "${env:HOME}/.cursor/extensions/yellow-hammer.mcp-1c-platform-tools-0.1.0/out/src/index.js" (подставьте свою версию вместо 0.1.0). После обновления расширения версия в имени папки может измениться — тогда обновите путь в конфиге.
Убедитесь, что расширение 1c-platform-tools установлено, IPC включён (1c-platform-tools.ipc.enabled = true) и в настройках расширения указаны те же порт и токен, что в env.
Общие параметры инструментов
Все MCP-инструменты принимают единый набор параметров:
| Параметр |
Обязательный |
Описание |
projectPath |
да |
Абсолютный путь к корню проекта 1С (где лежат packagedef и env.json) |
settingsFile |
нет |
Путь к env.json относительно projectPath (по умолчанию env.json) |
ibConnection |
нет |
Строка подключения к ИБ; если не указана, берётся из env.json или /F./build/ib |
pathsOverride |
нет |
Переопределение путей (cf, out, cfe, epf, erf) относительно projectPath |
Результат каждого инструмента — текстовое сообщение (например, Выполнено. или описание ошибки).
Типичный сценарий с агентом
- Агент изменяет исходники проекта 1С (например, в
src/cf или src/cfe).
- Агент вызывает MCP-инструмент (
configuration_loadFromSrc, extensions_loadFromSrc и т.д.).
- MCP отправляет запрос расширению по IPC; расширение выполняет команду (vrunner) и возвращает результат.
Для разработчиков
Сборка из исходников и участие в разработке — см. CONTRIBUTING.md.
