# 1c-dev-mcp

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

## Что такое MCP?

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

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

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

```powershell
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/USER_GUIDE.md)** — руководство пользователя (начните отсюда)
- [docs/INSTALL.md](docs/INSTALL.md)
- [docs/QUICKSTART.md](docs/QUICKSTART.md)
- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
- [docs/MCP_TOOLS.md](docs/MCP_TOOLS.md)
- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)

## Статус

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