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를 참조하세요.