drxinfra knowledge base for Directum RX

rxkb: drxinfra knowledge base for Directum RX over MCP

Public MCP server with the drxinfra.ru knowledge base for Directum RX administrators. An AI agent (Claude Code, Cursor, Claude Desktop, VS Code, Cline and any client with remote MCP) asks it directly: look up an error by a log line in a reference of about 200 errors (RX services, Directum Launcher, PostgreSQL, RabbitMQ, Elasticsearch, certificates, Keycloak, nginx, Docker, Kubernetes), read articles, search the site, size servers for RX and for a local AI assistant with the same numbers as the site calculators, check component versions, walk the upgrade checklist and the weighted security self-assessment. Endpoint https://drxinfra.ru/mcp (Streamable HTTP, MCP 2026-07-28 and earlier), read-only, no sign-in, no outbound connections, request contents are not stored. Content is in Russian.

claude mcp add --transport http rxkb https://drxinfra.ru/mcp

MCP-сервер с базой знаний drxinfra.ru для администраторов Directum RX. ИИ-агент спрашивает его сам, без браузера и копирования со страниц: что значит строка из лога, как это проверить и исправить, сколько серверов нужно под RX, какое железо под локальную модель ИИ, какие версии PostgreSQL и Elasticsearch поддерживаются, что не забыть при обновлении.

Адрес: https://drxinfra.ru/mcp. Только чтение, без регистрации и ключей. Страница для людей: drxinfra.ru/mcp.html.

Подключение

Claude Code

claude mcp add --transport http rxkb https://drxinfra.ru/mcp

Cursor (~/.cursor/mcp.json или .cursor/mcp.json в проекте)

{ "mcpServers": { "rxkb": { "url": "https://drxinfra.ru/mcp" } } }

VS Code (.vscode/mcp.json)

{ "servers": { "rxkb": { "type": "http", "url": "https://drxinfra.ru/mcp" } } }

Claude Desktop и claude.ai: Settings → Connectors → Add custom connector, адрес https://drxinfra.ru/mcp.

Другие клиенты (Cline, Roo Code, Continue, OpenCode, Cherry Studio и агенты на моделях DeepSeek, Qwen, GigaChat): тип сервера Streamable HTTP, тот же адрес. Клиенту, который умеет только stdio, поможет мост: npx -y mcp-remote https://drxinfra.ru/mcp.

Проверить, что сервер отвечает, можно без клиента:

curl -s https://drxinfra.ru/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Инструменты

Инструмент	Что делает
find_error	строка лога или текст ошибки → статьи справочника: дословная ошибка, что это значит, как проверить, что сделать, ссылка. Те же шаблоны и тот же порядок, что в поле разбора на drxinfra.ru/errors
get_article	полный текст статьи блога или страницы ошибки по id или адресу на drxinfra.ru
search_site	поиск по статьям, ошибкам и страницам инструментов с той же выдачей, что у поиска на сайте
size_rx	серверы, vCPU, память и диски под RX по ролям для прода, теста и препрода. Считает та же модель, что калькулятор сайзинга, и ответ содержит ссылку, по которой этот же расчёт открывается на сайте
size_ai	железо под локального ИИ-помощника RX по нашим замерам llama.cpp на CPU: серверы, память, время ответа, качество ответов, сравнение моделей, как на сайте
component_versions	версии ОС, Docker, PostgreSQL и совместимых СУБД, MS SQL, RabbitMQ, Elasticsearch и Kubernetes для RX 4.12 и 25.2 по документам вендора. Для других версий честно говорит, что данных нет
upgrade_checklist	чек-лист обновления RX: 44 пункта в 7 этапах, отметки и ссылка, по которой они открываются на странице чек-листа
security_self_check	22 вопроса самооценки безопасности с весами; по ответам балл, зона и список дыр в том же порядке, что на сайте

Каждый ответ заканчивается ссылкой на страницу drxinfra.ru, откуда он взят, и строкой, куда писать, если нужна помощь.

Примеры вопросов агенту:

• «В логе WebServer Npgsql.PostgresException: 53300: sorry, too many clients already, что делать?»
• «Посчитай серверы под RX на 1500 пользователей, Kubernetes, отказоустойчивость, 300 тысяч документов в год»
• «Какое железо нужно под локальную модель для помощника RX на 500 сотрудников?»
• «Какие версии Elasticsearch поддерживает RX 25.2?»
• «Пройдём самооценку безопасности нашего контура по вопросам drxinfra»

Что сервер видит и что хранит

• Сервер получает только аргументы вызова: строку лога, запрос поиска, параметры расчёта. Перед отправкой строки лога уберите из неё пароли, токены, имена серверов и персональные данные: для разбора нужна только сама ошибка.
• Аргументы нигде не сохраняются. В журнале сервиса на каждый запрос одна строка: метод, имя инструмента, имя клиента, код ответа, размеры и время. Адресов и аргументов там нет. Журнал веб-сервера пишет обрезанный адрес (последний октет нулевой) и путь /mcp без тела запроса, как для всего сайта.
• Сервер никуда не ходит: все данные в одном файле, собранном из исходников сайта при выкладке.
• Ограничения: частота запросов с одного адреса, одновременные запросы, размер запроса и время ответа. Подробно: docs/security.md.

Как устроено

сайт (статьи, справочник ошибок, калькуляторы) ──hack/build-kb.py──▶ kb.json ──▶ rxkb ──Streamable HTTP──▶ ИИ-агент

• hack/build-kb.py собирает kb.json из исходников сайта: markdown статей и ошибок, индекс поиска, модели калькуляторов, вопросы и чек-листы из разметки страниц. Только стандартная библиотека Python.
• Модель сайзинга RX сервер выполняет как есть: это тот же assets/sizing.js, что считает в браузере, во встроенном интерпретаторе JavaScript (goja). Скрипт приходит из репозитория сайта при сборке, запрос передаёт только проверенные числа и значения из списка.
• Разбор строки лога, поиск, железо под ИИ, самооценка и чек-лист повторены на Go строка в строку за скриптами сайта. hack/parity/site-check.mjs прогоняет одни и те же входы через сервер и через страницы сайта в headless Chrome и сравнивает ответы. Если скрипт сайта меняется, сервер пишет предупреждение при загрузке базы.
• Протокол: официальный Go SDK MCP, режим без сессий, ответы JSON. Клиенты на протоколе 2026-07-28 работают через server/discover, старые (2025-11-25, 2025-06-18, 2025-03-26) через initialize.

Разработка

go test ./...                                    # тесты на тестовом мини-сайте testdata/site
go run . -kb testdata/kb.json -listen 127.0.0.1:8790
python3 hack/build-kb.py --site ../landing --out /tmp/kb.json   # база из настоящего сайта
go run . -kb /tmp/kb.json -check                 # что в базе
node hack/parity/site-check.mjs --mcp http://127.0.0.1:8790/mcp --site https://drxinfra.ru/

Проверки перед коммитом и в CI: gofmt, go vet, go test, hack/leakcheck.sh, hack/vulncheck.sh (trivy по бинарнику и образу). Выкладка на сервер: docs/deploy.md. Изменения: CHANGELOG.md.

Лицензия

Код под Apache 2.0, см. LICENSE и NOTICE. Имена rxkb и drxinfra лицензия не передаёт: форк распространяйте под другим именем. Тексты статей и справочника drxinfra.ru в репозиторий не входят и под эту лицензию не попадают: сервер отдаёт их со ссылкой на сайт.

Directum RX — продукт компании Directum. Проект с вендором не связан.