rpmc-superops-mcp

RPM Computers (RPMC) 向けのスタンドアロン SuperOps MCP サーバー。

これは WYRE、Computask、Servosity のフォークではありません。これらのプロジェクトは実装の提供元であり、ライブ API の参照先です。docs/PROVENANCE.md を参照してください。

フェーズ 1: 認証付き、読み取り専用、QNAP (LAN) 上の 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 を設定してください。LAN 上の 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 を参照してください。