rpmc-superops-mcp

Автономный SuperOps MCP-сервер для RPM Computers (RPMC).

Это не форк WYRE, Computask или Servosity. Эти проекты — доноры реализации и справочники по живому API. См. docs/PROVENANCE.md.

Этап 1: аутентифицированный, только для чтения, Docker на QNAP (LAN). Инструменты записи не зарегистрированы и не отображаются в tools/list.

Среда выполнения

• Node.js 24

• MCP TypeScript SDK v2 (@modelcontextprotocol/server + @modelcontextprotocol/node)

• stdio (настольные MCP-клиенты) или Streamable HTTP (QNAP)

• Учётные данные SuperOps — только из окружения контейнера/процесса

• HTTP-клиенты MCP должны отправлять Authorization: Bearer <MCP_AUTH_TOKEN> (MCP_AUTH_TOKEN ≥ 32 символов)

• stdio не требует MCP_AUTH_TOKEN

См. docs/MCP-SDK.md о политике Host/Origin и решении по v2.

Related MCP server: runtime-inspector-mcp

Быстрый старт (разработка)

cp .env.example .env
npm install
npm test
npm run build

HTTP:

MCP_TRANSPORT=http MCP_AUTH_TOKEN=... SUPEROPS_API_TOKEN=... SUPEROPS_SUBDOMAIN=... SUPEROPS_REGION=us npm start

Вызывающие:

POST /mcp
Authorization: Bearer <MCP_AUTH_TOKEN>
Accept: application/json, text/event-stream

HTTP не сохраняет состояние (новый MCP-сервер на каждый запрос), поэтому он работает за будущим переходом Cloudflare Access/Tunnel без липких сессий. /health не требует аутентификации для Docker HEALTHCHECK и не раскрывает токены или содержимое тикетов.

Если браузерный клиент будет отправлять Origin, задайте MCP_ALLOWED_ORIGINS. Для LAN QNAP или будущего hostname туннеля задайте MCP_ALLOWED_HOSTS (или задайте Origins и позвольте Host использовать этот список). Небраузерные клиенты, не отправляющие Origin, продолжают работать; наличие Host всегда обязательно на /mcp.

Docker

docker build -t rpmc-superops-mcp:local .
docker run --rm -p 127.0.0.1:8080:8080 --env-file /secure/path/.env rpmc-superops-mcp:local

См. docker-compose.sample.yml. Production compose остаётся на QNAP и не коммитится.

CI собирает образ при каждом push (без публикации в реестр). Локальный/QNAP smoke-тест образа по-прежнему обязателен на машине с Docker.

Конфиденциальность

JSON-полезные нагрузки инструментов проходят через консервативный проход безопасного вывода: высоковероятные секреты в свободных строках заменяются на [redacted] и помечаются через _privacy, когда что-то изменилось. content разговоров/заметок также очищается от HTML. Вложения остаются только метаданными. Полезные технические доказательства сохраняются. Это не DLP.

Лицензия

Apache-2.0. См. LICENSE, NOTICE и THIRD_PARTY_NOTICES.md.