drxinfra knowledge base for Directum RX

rxkb：用于通过 MCP 访问 Directum RX 的 drxinfra 知识库

面向 Directum RX 管理员、提供 drxinfra.ru 知识库的公共 MCP 服务。 AI Agent（Claude Code、Cursor、Claude Desktop、VS Code、Cline，以及任何支持远程 MCP 的客户端）可以直接向它提问：根据日志行查询约 200 种错误的参考资料（涵盖 RX 服务、Directum Launcher、PostgreSQL、RabbitMQ、Elasticsearch、证书、Keycloak、nginx、Docker、Kubernetes），阅读文章、搜索网站、为 RX 和本地 AI 助手配置服务器（使用与网站计算器相同的数据）、检查组件版本、逐项完成升级清单和加权安全自评。端点为 https://drxinfra.ru/mcp（Streamable HTTP，支持 MCP 2026-07-28 及更早版本），只读，无需登录，不会建立外部连接，也不会存储请求内容。内容为俄语。

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

用于 Directum RX 管理员的 MCP 服务，提供 drxinfra.ru 知识库。AI Agent 可以直接向它提问，无需打开浏览器或从页面复制内容：日志中的某一行是什么意思、如何检查和修复、RX 需要多少台服务器、本地 AI 模型需要什么硬件、支持哪些版本的 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 模型的 Agent）：服务器类型为 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	按生产、测试和预生产环境的角色，计算 RX 所需的服务器、vCPU、内存和磁盘。使用与容量规划计算器相同的模型，答复中包含链接，可在网站上打开同一计算结果
size_ai	为 RX 本地 AI 助手配置硬件，根据我们使用 llama.cpp 在 CPU 上进行的测量，提供服务器、内存、响应时间、答复质量和模型比较，详见网站
component_versions	根据供应商文档，列出 RX 4.12 和 25.2 支持的 OS、Docker、PostgreSQL 及兼容的 DBMS、MS SQL、RabbitMQ、Elasticsearch 和 Kubernetes 版本。对于其他版本，会如实说明没有相关数据
upgrade_checklist	RX 升级检查清单：分为 7 个阶段，共 44 项，提供勾选项和链接，可在检查清单页面打开
security_self_check	包含权重的 22 个安全自评问题；根据答复计算分数和等级，并按与网站相同的顺序列出漏洞

每条答复都会以其来源的 drxinfra.ru 页面链接和需要帮助时的联系信息结尾。

向 Agent 提问示例：

• “WebServer 日志中出现 Npgsql.PostgresException: 53300: sorry, too many clients already，该怎么办？”
• “请计算支持 1,500 名用户、Kubernetes、高可用性且每年处理 30 万份文档的 RX 所需服务器”
• “为 500 名员工使用的 RX 本地助手模型需要什么硬件？”
• “RX 25.2 支持哪些 Elasticsearch 版本？”
• “我们来通过 drxinfra 的问题对我们的环境进行安全自评吧”

服务器会看到和存储哪些信息

• 服务器只会收到调用参数：日志行、搜索查询或计算参数。发送日志行前，请删除其中的密码、令牌、服务器名称和个人数据；解析只需要错误本身。
• 参数不会存储在任何地方。服务日志中每个请求只记录一行：方法、工具名称、客户端名称、响应代码、大小和耗时。不记录地址和参数。与整个网站一样，Web 服务器日志会记录经过截断的地址（最后一个八位组为零）和路径 /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. Проект с вендором не связан.