codemagic_mcp

MCP-сервер для API CI/CD Codemagic. 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

Конфигурация

Переменные окружения:

Запуск

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.

• Ошибки сопоставляются с типизированными классами (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