English Français العربية

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

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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>"
            }
        }
    }
}

متغيرات البيئة

  • ONEC_IPC_PORT إلزامي Порт IPC-сервера расширения 1c-platform-tools (настройка 1c-platform-tools.ipc.port)
  • ONEC_IPC_TOKEN سري Токен IPC (если задан в 1c-platform-tools.ipc.token)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

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

الأسئلة الشائعة

ما هو io.github.yellow-hammer/mcp-1c-platform-tools؟

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

كيف أثبّت io.github.yellow-hammer/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.yellow-hammer/mcp-1c-platform-tools إلى مفتاح API؟

نعم. يتطلب ONEC_IPC_PORT, ONEC_IPC_TOKEN، وتضبطها في إعداداته.

هل io.github.yellow-hammer/mcp-1c-platform-tools مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.yellow-hammer/mcp-1c-platform-tools؟

ينشره yellow-hammer. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.