1c-dev-mcp

Локальный MCP-сервер для разработки 1С в Cursor: справка платформы + XML-проект.

Что такое MCP?

MCP (Model Context Protocol) — протокол, через который Cursor подключается к внешним инструментам. Сервер 1c-dev-mcp даёт AI доступ к справке 1С и к выгруженной XML-конфигурации без ручного копирования файлов.

Быстрый старт

1. Python 3.11+
2. Запустите установщик:

cd "C:\Users\twost\Desktop\MCP Help\1c-dev-mcp"
.\install.ps1 -PlatformPath "C:\Program Files (x86)\1cv8t\8.3.27.1508"

3. Перезапустите Cursor
4. Откройте папку с XML-выгрузкой конфигурации
5. В чате попросите агента вызвать doctor, затем set_platform_version("8.3.27")

MCP tools

Tool	Назначение
list_platform_versions	Установленные версии 1С
set_platform_version	Выбор активной версии
get_platform_info	Статус справки и индекса
build_help_index	Индексация HBK
search_help / get_help	Справка платформы
get_project_status	Обнаружение XML-проекта
build_project_index	Индексация конфигурации
find_metadata / get_metadata / list_metadata	Метаданные
search_code / get_code	BSL-код
doctor	Диагностика

Важно про вашу платформу

Путь C:\Program Files (x86)\1cv8t\8.3.27.1508 — учебная/технологическая платформа (1cv8t).

В bin найден shquery_root.hbk (справка языка запросов), но нет shcntx_ru.hbk (полная справка API: ТаблицаЗначений, методы, типы).

Для сценариев «как работает метод платформы» нужна полная установка 1cv8 с shcntx_ru.hbk. Project Layer (метаданные, код XML) работает независимо.

Данные и кэш

%LOCALAPPDATA%\1c-dev-mcp\

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

• docs/USER_GUIDE.md — руководство пользователя (начните отсюда)
• docs/INSTALL.md
• docs/QUICKSTART.md
• docs/ARCHITECTURE.md
• docs/MCP_TOOLS.md
• docs/TROUBLESHOOTING.md

Статус

Компонент	Статус
Platform detector (1cv8 + 1cv8t)	Реализовано
HBK index (shquery/shcntx)	Реализовано
XML project index	Реализовано
MCP stdio	Реализовано
install.ps1	Реализовано
Cursor integration	Требует проверки на вашей машине