mcpField
M
mcp-1c-platform-tools

mcp-1c-platform-tools

Local
github.com/yellow-hammerDeveloper Tools42Updated 3d ago
Repository

About mcp-1c-platform-tools

mcp-1c-platform-tools is an MCP server that gives AI agents in VS Code or Cursor access to commands of the 1C: Platform Tools extension. It targets developers working on 1C configurator, 1C:EDT and OneScript projects, and requires the extension with IPC enabled.

Key features

  1. 01Runs tests and reports their results
  2. 02Switches launch profiles
  3. 03Reports environment state and platform version
  4. 04Builds configurations and works with the infobase
  5. 05Generates a project-level MCP config for Cursor

Use cases

  1. 01Letting an AI agent run 1C project tests from VS Code or Cursor
  2. 02Switching launch profiles and checking the database path by prompt
  3. 03Maintaining project-scoped Cursor MCP settings across several projects

MCP support

This project is an MCP server that exposes 1C: Platform Tools extension commands to AI agents in VS Code or Cursor, communicating with the extension over IPC.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "yellow-hammer-mcp-1c-platform-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-1c-platform-tools"
      ],
      "env": {
        "ONEC_IPC_PORT": "<ONEC_IPC_PORT>",
        "ONEC_IPC_TOKEN": "<ONEC_IPC_TOKEN>"
      }
    }
  }
}
Run commandnpx -y mcp-1c-platform-tools
Environment variables to set
ONEC_IPC_PORTПорт IPC-сервера расширения 1c-platform-tools (настройка 1c-platform-tools.ipc.port)
ONEC_IPC_TOKENSecretТокен IPC (если задан в 1c-platform-tools.ipc.token)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-1c-platform-tools0.1.5

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

1C: Platform Tools MCP

VS Marketplace Open VSX OpenYellow telegram chat Ask Devin

MCP-сервер даёт агенту VS Code или Cursor доступ к командам расширения 1C: Platform Tools в проектах конфигуратора, 1С:EDT и OneScript: тесты, профили запуска, сборка конфигурации, работа с базой.

Установка

  1. Установите 1C: Platform Tools: Marketplace, Open VSX
  2. Установите 1C: Platform Tools MCP: Marketplace, Open VSX
  3. Откройте проект 1С (папка с packagedef).

Подключение

VS Code больше ничего не требует: расширение регистрирует MCP-сервер само.

Cursor не поддерживает провайдер MCP-серверов VS Code, поэтому сервер подключается через .cursor/mcp.json проекта. Файл создаёт и обновляет расширение:

  1. Палитра команд (F1) → 1C: Platform Tools MCP: Настроить MCP для Cursor, либо в дереве Инструменты 1С → Навыки для AI → Настроить MCP для Cursor.
  2. Перезагрузите окно.
  3. Включите сервер mcp-1c-platform-tools в настройках MCP: новый сервер Cursor добавляет выключенным.

Команда пишет путь к серверу и параметры IPC; другие серверы в файле сохраняются. Путь содержит версию расширения, поэтому после обновления запись устаревает и сервер падает с MODULE_NOT_FOUND. Расширение чинит это при запуске: обновляет путь, если он ведёт на другую установку этого же расширения. Путь, прописанный вручную (например, на сборку из исходников), остаётся как есть.

Проверка

Напишите агенту «покажи состояние окружения 1С». В ответе будут активный профиль запуска, версия платформы и путь к базе. Дальше можно просить прогон тестов, переключение профиля, сборку конфигурации.

Документация

Каталог docs публикуется на сайте 1C: Platform Tools разделом MCP-сервер: установка и подключение, параметры инструментов, что писать агенту.

Настройка вручную

Нужна, только если конфиг заводится без расширения. Настройка 1c-platform-tools.ipc.enabled должна быть включена, значения ONEC_IPC_* берутся из 1c-platform-tools.ipc.*:

{
  "mcpServers": {
    "mcp-1c-platform-tools": {
      "command": "node",
      "args": ["<путь к каталогу расширения>/out/src/index.js"],
      "env": {
        "ONEC_IPC_HOST": "127.0.0.1",
        "ONEC_IPC_PORT": "40241",
        "ONEC_IPC_TOKEN": ""
      }
    }
  }
}

Каталог расширения: %USERPROFILE%\.cursor\extensions\yellow-hammer.mcp-1c-platform-tools-<версия>-universal (Windows) или ~/.cursor/extensions/... (macOS, Linux). После каждого обновления расширения такой путь придётся править руками.

Глобальный конфиг (%USERPROFILE%\.cursor\mcp.json) работает так же, но его расширение не обновляет: для нескольких проектов надёжнее проектный файл.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.