English Français العربية

io.github.yellow-hammer/mcp-1c-platform-tools

Official registry Other

MCP для команд 1c-platform-tools. Нужно расширение 1c-platform-tools с включённым IPC.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mcp-1c-platform-tools
Claude Code 
claude mcp add mcp-1c-platform-tools -e 'ONEC_IPC_PORT=<ONEC_IPC_PORT>' -e 'ONEC_IPC_TOKEN=<your onec_ipc_token>' -- npx -y mcp-1c-platform-tools@0.1.5
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-1c-platform-tools": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-1c-platform-tools@0.1.5"
            ],
            "env": {
                "ONEC_IPC_PORT": "<ONEC_IPC_PORT>",
                "ONEC_IPC_TOKEN": "<your onec_ipc_token>"
            }
        }
    }
}

Environment variables

  • ONEC_IPC_PORT required Порт IPC-сервера расширения 1c-platform-tools (настройка 1c-platform-tools.ipc.port)
  • ONEC_IPC_TOKEN secret Токен IPC (если задан в 1c-platform-tools.ipc.token)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 1C: Platform Tools MCP
  2. Установка
  3. Подключение
  4. Проверка
  5. Документация
  6. Настройка вручную

1C: Platform Tools MCP

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) работает так же, но его расширение не обновляет: для нескольких проектов надёжнее проектный файл.

Frequently asked questions

What is io.github.yellow-hammer/mcp-1c-platform-tools?

MCP для команд 1c-platform-tools. Нужно расширение 1c-platform-tools с включённым IPC.

How do I install io.github.yellow-hammer/mcp-1c-platform-tools?

It runs on your machine. In Claude Code: claude mcp add mcp-1c-platform-tools -e 'ONEC_IPC_PORT=<ONEC_IPC_PORT>' -e 'ONEC_IPC_TOKEN=<your onec_ipc_token>' -- npx -y mcp-1c-platform-tools@0.1.5. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.yellow-hammer/mcp-1c-platform-tools need an API key?

Yes. It expects ONEC_IPC_PORT, ONEC_IPC_TOKEN, which you set in its configuration.

Is io.github.yellow-hammer/mcp-1c-platform-tools open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.yellow-hammer/mcp-1c-platform-tools?

It is published by yellow-hammer. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.