rpmc-superops-mcp

Servidor MCP SuperOps independiente para RPM Computers (RPMC).

Esto no es un fork de WYRE, Computask o Servosity. Esos proyectos son donantes de implementación y referencias de API en vivo. Ver docs/PROVENANCE.md.

Fase 1: autenticado, solo lectura, Docker en QNAP (LAN). Las herramientas de escritura no están registradas y no aparecen en tools/list.

Entorno de ejecución

• Node.js 24

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

• stdio (clientes MCP de escritorio) o HTTP Streamable (QNAP)

• Credenciales de SuperOps solo desde el entorno del contenedor/proceso

• Los llamadores HTTP MCP deben enviar Authorization: Bearer <MCP_AUTH_TOKEN> (MCP_AUTH_TOKEN ≥ 32 caracteres)

• stdio no requiere MCP_AUTH_TOKEN

Ver docs/MCP-SDK.md para la política de Host/Origin y la decisión de v2.

Related MCP server: runtime-inspector-mcp

Inicio rápido (desarrollo)

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

Llamadores:

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

HTTP es sin estado (servidor MCP nuevo por solicitud), por lo que funciona detrás de un salto futuro de Cloudflare Access/Tunnel sin sesiones persistentes. /health no está autenticado para el HEALTHCHECK de Docker y no expone tokens ni contenido de tickets.

Si un cliente de navegador enviará Origin, establezca MCP_ALLOWED_ORIGINS. Para QNAP en LAN o un nombre de host de túnel futuro, establezca MCP_ALLOWED_HOSTS (o establezca Origins y deje que Host reutilice esa lista). Los clientes que no son de navegador y omiten Origin siguen funcionando; un Host presente siempre es requerido en /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

Ver docker-compose.sample.yml. El compose de producción permanece en QNAP y no se commitea.

CI construye la imagen en cada push (sin publicación en registro). La prueba de humo de imagen local/QNAP aún se requiere en una máquina con Docker.

Privacidad

Las cargas útiles JSON de las herramientas pasan por un proceso de salida segura conservador: los secretos de alta confianza en cadenas de formato libre se reemplazan con [redacted] y se marcan mediante _privacy cuando algo cambia. El content de conversaciones/notas también se limpia de HTML. Los adjuntos permanecen solo con metadatos. Se conserva evidencia técnica útil. Esto no es DLP.

Licencia

Apache-2.0. Ver LICENSE, NOTICE y THIRD_PARTY_NOTICES.md.