Skip to main content
Glama
zadig-mcp
by Deraiven

zadig-mcp

用于 Zadig OpenAPI 的基础 MCP 服务器。

工具

  • zadig_workflow_list:列出/搜索项目工作流。

  • zadig_workflow_get:获取一个自定义工作流的详细信息。

  • zadig_workflow_update:更新一个自定义工作流。默认进行试运行,需要 confirm=true。

  • zadig_workflow_task_list:列出工作流任务及其部署摘要。

  • zadig_workflow_task_detail:获取一个工作流任务的详细信息及其部署摘要。

  • zadig_workflow_task_job_log:获取一个工作流任务的作业日志,支持尾部跟踪和关键字过滤。

  • zadig_workflow_webhook_list:列出工作流已保存的 webhook/git 触发器设置。

  • zadig_workflow_webhook_preset:获取工作流当前的 webhook/git 触发器预设。

  • zadig_workflow_webhook_compare_to_preset:将已保存的 webhook/git 触发器设置与当前预设进行比较。

  • zadig_build_list:列出/搜索构建配置。

  • zadig_build_template_list:列出/搜索构建模板库中的模板。

  • zadig_build_template_get:按 ID 或精确名称获取一个构建模板库中的模板。

  • zadig_build_template_reference:列出引用某个构建模板的构建配置。

  • zadig_build_template_update:更新一个构建模板库中的模板。默认进行试运行,需要 confirm=true。

  • zadig_build_get:获取一个构建配置的详细信息。

  • zadig_build_update:更新一个构建配置。默认进行试运行,需要 confirm=true。

  • zadig_build_update_from_template:更新一个由构建模板创建的构建。默认进行试运行,需要 confirm=true。

  • zadig_service_search:列出/搜索 K8s YAML 服务。

  • zadig_service_get:获取服务详细信息,包括 YAML 和变量。

  • zadig_service_update_variables:替换服务变量。需要 confirm=true。

  • zadig_service_set_variable:新增或更新单个服务变量。默认进行试运行。

  • zadig_service_set_image:更新服务 YAML 中的容器镜像。默认进行试运行。

  • zadig_environment_list:列出测试或生产环境。

  • zadig_environment_service_get:获取环境中的服务详细信息。

Related MCP server: Dify Management MCP

配置

[mcp_servers.zadig]
command = "uv"
args = ["--directory", "/Users/storehub/Desktop/devops-tools-auto/zadig-mcp", "run", "zadig-mcp"]

[mcp_servers.zadig.env]
ZADIG_BASE_URL = "https://zadigx.shub.us"
ZADIG_TOKEN = "replace-me"
ZADIG_PROJECT = "devops-tools"
UV_CACHE_DIR = "/tmp/uv-cache"

ZADIG_PROJECT 是可选的。每个工具也接受 project_key。

工作流任务工具使用 Zadig v4 工作流任务读取 API,默认返回简洁摘要。仅当调用方需要原始任务负载时,才设置 include_raw=true;返回前会递归脱敏类似凭据的字段。

开发

uv run python -m py_compile zadig_mcp/*.py
uv run zadig-mcp

Available Tools

49 tools
zadig_build_applyC

Create or update one Zadig build. mode can be auto, create, or update. Defaults to dry_run=true.

Inputs: build (required), build_name (required), mode, confirm, +4 more. Returns: object

zadig_build_createA

Create one Zadig build. Defaults to dry_run=true and requires confirm=true.

Inputs: build (required), build_name (required), confirm, dry_run, +2 more. Returns: object

zadig_build_deleteA

Delete one Zadig build. Defaults to dry_run=true and requires confirm=true.

Inputs: build_name (required), confirm, dry_run, project_key. Returns: object

zadig_build_diffB

Diff current Zadig build detail against desired build payload.

Inputs: build (required), build_name (required), project_key. Returns: object

zadig_build_getC

Get one Zadig build configuration detail.

Inputs: build_name (required), project_key, service_name, service_module. Returns: object

zadig_build_listC

List/search Zadig build configurations.

Inputs: query, page_num, page_size, include_raw, +1 more. Returns: object

zadig_build_template_applyB

Create or update one build template. mode can be auto, create, or update. Defaults to dry_run=true.

Inputs: template (required), mode, confirm, dry_run, +3 more. Returns: object

zadig_build_template_createC

Create one build template store template. Defaults to dry_run=true and requires confirm=true.

Inputs: template (required), confirm, dry_run, allow_redacted. Returns: object

zadig_build_template_deleteC

Delete one build template store template. Defaults to dry_run=true and requires confirm=true.

Inputs: confirm, dry_run, template_id, template_name. Returns: object

zadig_build_template_diffB

Diff current Zadig build template detail against desired template payload.

Inputs: template (required), template_id, template_name. Returns: object

zadig_build_template_getB

Get one build template store template by id or exact name.

Inputs: template_id, template_name. Returns: object

zadig_build_template_listC

List/search build template store templates.

Inputs: query, include_raw. Returns: object

zadig_build_template_referenceA

List build configurations that reference one build template.

Inputs: template_id, template_name. Returns: object

zadig_build_template_updateC

Update one build template store template. Defaults to dry_run=true and requires confirm=true.

Inputs: template (required), confirm, dry_run, template_id, +1 more. Returns: object

zadig_build_updateB

Update one Zadig build configuration. Defaults to dry_run=true and requires confirm=true.

Inputs: build (required), build_name (required), confirm, dry_run, +3 more. Returns: object

zadig_build_update_from_templateB

Update a build created from a build template. Defaults to dry_run=true and requires confirm=true.

Inputs: build_name (required), template_name (required), target_services (required), confirm, +2 more. Returns: object

zadig_environment_applyB

Create or update a Zadig environment. mode can be auto, create, or update. Defaults to dry_run=true.

Inputs: environment (required), mode, confirm, dry_run, +4 more. Returns: object

zadig_environment_createB

Create a Zadig environment. Defaults to dry_run=true and requires confirm=true.

Inputs: environment (required), confirm, dry_run, env_name, +3 more. Returns: object

zadig_environment_deleteB

Delete a Zadig environment. Defaults to dry_run=true and requires confirm=true.

Inputs: env_name (required), confirm, dry_run, is_delete, +2 more. Returns: object

zadig_environment_diffC

Diff current Zadig environment against desired Environment spec.

Inputs: environment (required), env_name, production, project_key. Returns: object

zadig_environment_getC

Get a Zadig environment detail.

Inputs: env_name (required), production, project_key. Returns: object

zadig_environment_listC

List Zadig environments.

Inputs: production, project_key. Returns: object

zadig_environment_service_applyA

Add or update one service in a Zadig environment. Defaults to dry_run=true and requires confirm=true.

Inputs: service (required), env_name (required), mode, confirm, +4 more. Returns: object

zadig_environment_service_deleteA

Delete one service from a Zadig environment. Defaults to dry_run=true and requires confirm=true.

Inputs: env_name (required), service_name (required), confirm, dry_run, +3 more. Returns: object

zadig_environment_service_getC

Get service detail in a Zadig environment.

Inputs: env_name (required), service_name (required), production, project_key, +1 more. Returns: object

zadig_environment_service_listB

List services deployed in a Zadig environment.

Inputs: env_name (required), production, project_key. Returns: object

zadig_environment_updateC

Update a Zadig environment. Defaults to dry_run=true and requires confirm=true.

Inputs: env_name (required), environment (required), confirm, dry_run, +4 more. Returns: object

zadig_project_getB

Get one Zadig project as a redacted GitOps Project document.

Inputs: project_key. Returns: object

zadig_project_planB

Plan Zadig project create/update/delete. This is always dry-run and never mutates.

Inputs: mode, project, project_key. Returns: object

zadig_project_snapshotC

Create a redacted project snapshot for audit/GitOps preparation.

Inputs: sections, project_key, max_workflows, workflow_names, +1 more. Returns: object

zadig_service_getC

Get a Zadig K8s YAML service detail.

Inputs: service_name (required), production, project_key. Returns: object

zadig_service_set_imageA

Update one container image in service YAML. Defaults to dry_run=true and returns a diff.

Inputs: image (required), service_name (required), container_name (required), confirm, +3 more. Returns: object

zadig_service_set_variableC

Upsert a single service variable. Defaults to dry_run=true.

Inputs: key (required), value (required), service_name (required), desc, +6 more. Returns: object

zadig_service_update_variablesA

Replace all service variables. This is mutating and requires confirm=true.

Inputs: service_name (required), service_variable_kvs (required), confirm, production, +1 more. Returns: object

zadig_service_update_yamlB

Replace service YAML. This is mutating and requires confirm=true.

Inputs: yaml (required), service_name (required), confirm, production, +2 more. Returns: object

zadig_workflow_applyC

Create or update a custom workflow. mode can be auto, create, or update. Defaults to dry_run=true.

Inputs: workflow (required), workflow_name (required), mode, confirm, +3 more. Returns: object

zadig_workflow_createC

Create a custom workflow. Defaults to dry_run=true and requires confirm=true.

Inputs: workflow (required), workflow_name (required), confirm, dry_run, +2 more. Returns: object

zadig_workflow_deleteA

Delete a custom workflow. Defaults to dry_run=true and requires confirm=true.

Inputs: workflow_name (required), confirm, dry_run, project_key. Returns: object

zadig_workflow_diffC

Diff current Zadig workflow detail against a desired workflow payload.

Inputs: workflow (required), workflow_name (required), project_key. Returns: object

zadig_workflow_getC

Get one custom workflow detail.

Inputs: workflow_name (required), include_raw, project_key. Returns: object

zadig_workflow_listC

List Zadig workflows in a project.

Inputs: query, project_key. Returns: object

zadig_workflow_task_detailB

Get a Zadig workflow task detail with deployment summaries.

Inputs: task_id (required), workflow_name (required), include_raw, project_key. Returns: object

zadig_workflow_task_job_logB

Get one Zadig workflow task job log. Supports tail_lines and keyword filtering.

Inputs: task_id (required), job_name (required), workflow_name (required), keyword, +3 more. Returns: object

zadig_workflow_task_listC

List Zadig workflow tasks with optional deployment summaries.

Inputs: workflow_name (required), filters, job_name, page_num, +5 more. Returns: object

zadig_workflow_updateA

Update a custom workflow. Defaults to dry_run=true and requires confirm=true to mutate.

Inputs: workflow (required), workflow_name (required), confirm, dry_run, +2 more. Returns: object

zadig_workflow_webhook_compare_to_presetB

Compare saved webhook/git trigger settings with the current workflow webhook preset.

Inputs: workflow_name (required), include_raw, project_key. Returns: object

zadig_workflow_webhook_listB

List webhook/git trigger settings for one Zadig workflow.

Inputs: workflow_name (required), include_raw, project_key. Returns: object

zadig_workflow_webhook_presetC

Get the current webhook/git trigger preset for one Zadig workflow.

Inputs: workflow_name (required), include_raw, project_key. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 49 tools

    Disambiguation3/5

    Most tools map to a clear resource+action, but several overlapping groups create ambiguity: create/update/apply trios exist for workflows, builds, build templates, and environments, and service_update_variables vs service_set_variable plus service_update_yaml vs service_set_image require careful reading to distinguish. The descriptions help, but the redundancy is noticeable.

    Naming Consistency4/5

    The naming follows a consistent snake_case zadig_<resource>_<action> pattern with clear nesting for subresources like environment_service and workflow_task. Minor deviations exist where noun-style names are used instead of explicit verbs, such as project_snapshot, workflow_task_detail, workflow_webhook_preset, and build_template_reference.

    Tool Count2/5

    With 49 tools, this is well above the 25+ threshold and feels heavy even for a broad platform like Zadig. The count is not excessive for the domain's full feature set, but it places a large burden on agent context and tool selection.

    Completeness2/5

    The set provides good lifecycle coverage for workflows, builds, build templates, and environments, plus useful task and webhook read tools. However, project mutation is missing entirely (project_plan is always dry-run and there is no project_apply/create/update/delete), and services have no create or delete operations, leaving significant gaps in core GitOps workflows.

    Related MCP Connectors

    Related MCP Servers