MCP 서버
MCP(Model Context Protocol)는 AI 에이전트에게 도구를 제공하는 표준입니다. Ratatosk의 MCP 서버를 붙이면 에이전트가 릴리스 facts를 직접 조회하고, 구동 중인 스택과 대조할 수 있습니다.
- 소스·설치·설정 (정본): github.com/garlicKim21/ratatosk-mcp
- 컨테이너 이미지:
ghcr.io/garlickim21/ratatosk-mcp - 읽기 전용입니다. 클러스터에 어떤 변경도 가하지 않습니다.
도구 네 가지
| 도구 | 하는 일 |
|---|---|
list_facts |
fact 증분 피드 (프로젝트·타입·심각도 필터, 커서 폴링) |
facts_by_entity |
식별자 하나(CVE·CRD·플래그 등)를 건드린 모든 fact |
get_release |
릴리스 하나의 리뷰 전체. 원문 포함 옵션 |
check_stack |
구동 중인 버전 목록과 facts를 대조해 업그레이드 경로의 조치 사항을 브리핑 |
check_stack의 프라이버시 설계
구동 중인 버전은 민감한 정보일 수 있습니다. check_stack은 버전 비교를 MCP 서버 프로세스 안에서만 수행합니다. ratatosk.io로 전송되는 것은 프로젝트 이름뿐이고, 버전 번호는 밖으로 나가지 않습니다. 이 동작은 공개 레포의 코드로 확인할 수 있습니다.
실행 형태
- stdio: Claude Code 등 로컬 에이전트에 붙일 때. 바이너리 하나면 됩니다.
- HTTP (클러스터 내부):
MCP_HTTP_ADDR을 주면 스트리밍 HTTP 서버로 떠서 클러스터 안의 에이전트들이 Service로 접속합니다. Helm 차트가 레포에 있습니다.
설치 명령과 구체적 설정 예시는 레포 README(영어·한국어·일본어)에 있습니다.
서버 카드
에이전트가 기계적으로 발견할 수 있도록 표준 서버 카드를 게시합니다: /.well-known/mcp/server-card.json