codemagic_mcp

Codemagic CI/CD API를 위한 MCP 서버입니다. Bun + TypeScript, stdio 전송 방식을 사용합니다.

도구

앱

codemagic_get_all_applications
codemagic_get_application
codemagic_add_application
codemagic_add_application_private

빌드

codemagic_start_build
codemagic_get_builds
codemagic_get_build_status
codemagic_cancel_build

아티팩트

codemagic_get_artifact (메타데이터 + base64 미리보기를 반환합니다. 전체 다운로드는 공개 URL 도구를 사용하세요)
codemagic_create_public_artifact_url

캐시

codemagic_get_app_caches
codemagic_delete_all_app_caches
codemagic_delete_app_cache

팀

codemagic_invite_team_member
codemagic_delete_team_member

구성

환경 변수:

변수	필수	기본값	참고
`CODEMAGIC_API_KEY`	예	—	팀 설정 → 개인 계정 → API에서 확인
`CODEMAGIC_BASE_URL`	아니요	`https://api.codemagic.io`	자체 호스팅/스테이징용 재정의
`CODEMAGIC_TIMEOUT_MS`	아니요	`30000`	요청당 타임아웃
`CODEMAGIC_MAX_RETRIES`	아니요	`3`	408/425/429/5xx 및 네트워크 오류 시 재시도 (지터가 포함된 지수 백오프, `Retry-After` 준수)

실행

bun install
CODEMAGIC_API_KEY=... bun run start

감시 모드:

CODEMAGIC_API_KEY=... bun run dev

공식 MCP 인스펙터로 검사:

CODEMAGIC_API_KEY=... bun run inspect

Claude Code / Claude Desktop 설정

한 줄 설정:

claude mcp add codemagic --scope user \
  -e CODEMAGIC_API_KEY=<your_key> \
  -- bunx codemagic_mcp

또는 claude_desktop_config.json에서 수동 설정:

{
  "mcpServers": {
    "codemagic": {
      "command": "bunx",
      "args": ["codemagic_mcp"],
      "env": { "CODEMAGIC_API_KEY": "..." }
    }
  }
}

보안 참고 사항

API 키는 환경 변수에서만 읽어옵니다.
나가는 요청은 x-auth-token을 통해 키를 전송하며, 절대 로그에 남지 않습니다.
모든 도구 출력(텍스트 및 구조화된 데이터)은 키 값과 authorization, x-auth-token, api[-_]?key, password, passphrase, ssh[-_]?key, secret, token과 일치하는 모든 객체 키를 마스킹하는 리액터(redactor)를 거칩니다.
오류는 유형별 클래스(CodemagicAuthError, CodemagicNotFoundError, CodemagicValidationError, CodemagicRateLimitError, CodemagicServerError, CodemagicNetworkError)로 매핑되어 실행 가능한 메시지로 표시되며, 내부 스택 트레이스는 클라이언트에 노출되지 않습니다.

레이아웃

src/
  index.ts          stdio entrypoint
  schemas.ts        Zod input schemas
  lib/
    config.ts       env loading + validation
    client.ts       fetch wrapper: timeouts, retries, status mapping
    errors.ts       typed error classes + user-facing formatter
    redact.ts       secret/string + key-pattern redaction
    response.ts     jsonResult / textResult / errorResult helpers
  tools/
    apps.ts builds.ts artifacts.ts caches.ts teams.ts