rpmc-superops-mcp

为 RPM Computers (RPMC) 提供的独立 SuperOps MCP 服务器。

这不是 WYRE、Computask 或 Servosity 的分支。这些项目是实现贡献者和实时 API 参考。参见 docs/PROVENANCE.md。

第一阶段：在 QNAP（局域网）上运行 Docker，需认证、只读。写入工具未注册，也不会出现在 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

有关 Host/Origin 策略和 v2 决策，请参阅 docs/MCP-SDK.md。

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。对于局域网 QNAP 或未来的隧道主机名，请设置 MCP_ALLOWED_HOSTS（或设置 Origins，并让 Host 复用该列表）。省略 Origin 的非浏览器客户端仍可继续工作；在 /mcp 上始终需要提供 Host。

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。生产环境的 compose 配置保留在 QNAP 上，不会提交。

CI 在每次推送时构建镜像（不发布到镜像仓库）。仍然需要在装有 Docker 的机器上对本地/QNAP 镜像进行冒烟测试。

隐私

工具 JSON 负载会经过一次保守的安全输出处理：自由格式字符串中高置信度的机密会被替换为 [redacted]，并在发生任何更改时通过 _privacy 标记。对话/笔记的 content 也会去除 HTML。附件仅保留元数据。有用的技术证据会保留。这不是 DLP。

许可证

Apache-2.0。参见 LICENSE、NOTICE 和 THIRD_PARTY_NOTICES.md。