Разверни BxMCP из этого репозитория на текущей машине.

1. Прочитай HOWTO.md целиком — это инструкция по установке.
2. Проверь требования (Node 22+, Python 3.12+, RAM, swap) и скажи,
   чего не хватает.
3. Спроси меня: разворачиваем локально или на сервере с Bitrix,
   и какой путь к установке Bitrix (BITRIX_PATH).
4. Выполни шаги из HOWTO.md по порядку: зависимости, сборка, сервис
   эмбеддингов, systemd, индексация.
5. После каждого этапа проверяй результат теми командами, что есть в HOWTO.
6. В конце покажи мне готовый JSON для подключения MCP-клиента.

Не меняй файлы в /bitrix. Все пути и порты бери из HOWTO.md.

# 1. зависимости, Node 22+, Python 3.12, swap
# 2. код
cd /opt && git clone <этот-репозиторий> bitrix-mcp && cd bitrix-mcp
npm install && npm run build

# 3. сервис эмбеддингов (CPU-сборка torch)
cd src/python
python3 -m venv venv-gemma2
./venv-gemma2/bin/pip install --index-url https://download.pytorch.org/whl/cpu torch torchvision
./venv-gemma2/bin/pip install -r requirements.txt

# 4. документация
cd /opt/bitrix-mcp/data
git clone --depth 1 https://github.com/bitrix-tools/framework-docs.git docs

# 5. systemd-юниты и запуск
cp /opt/bitrix-mcp/src/bxmcp.service /opt/bitrix-mcp/src/bxmcp-embeddings.service /etc/systemd/system/
systemctl daemon-reload && systemctl enable --now bxmcp-embeddings bxmcp

# 6. индексация
curl -X POST http://127.0.0.1:3100/admin/reindex             # модули (~11 мин)
curl -X POST http://127.0.0.1:3100/admin/reindex-components  # компоненты
curl -X POST http://127.0.0.1:3100/admin/reindex-docs        # документация (~3 ч)

Найди функцию GetList в модуле main и покажи её код с сигнатурой

Как правильно использовать \Bitrix\Main\ORM\Query\Query? Поищи в документации про ORM

Какие события есть в модуле sale? Покажи все зарегистрированные события

BxMCP Server (Node.js, порт 3100)
  ├── LiveAPI — парсит PHP-файлы Bitrix (/bitrix/modules/ и /bitrix/components/)
  ├── Docs — поиск по markdown-документации (git)
  ├── Embeddings (Python, порт 8000) — EmbeddingGemma 2, семантический поиск
  ├── Analytics — SQLite-статистика использования (/admin/stats, /admin/usage)
  └── SQLite — индекс функций, классов, событий, чанков docs

curl -s http://127.0.0.1:3100/health | jq .          # версия, модель, подпись индекса
curl -s http://127.0.0.1:8000/health | jq .          # сервис эмбеддингов

curl -s -X POST http://127.0.0.1:3100/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"liveApiListModules","arguments":{}},"id":1}' \
  | jq -r .result.content[0].text

{
  "mcpServers": {
    "bitrix": {
      "url": "http://127.0.0.1:3100/mcp"
    }
  }
}

{
  "mcpServers": {
    "bitrix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:3100"]
    }
  }
}