zadig-mcp
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-mcpAvailable Tools
49 toolszadig_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_searchC
Search Zadig K8s YAML services by service, container, image name or image.
Inputs: query, 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
Scored across 49 tools
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.
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.
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.
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
Manage repositories, users, releases, and automate GitHub workflows
Users, organizations, roles, permissions, applications and feature flags.
Trigger and inspect Codemagic CI builds, apps and artifacts.
Programmatic control of the Hiro security platform: scans, tasks, plans, and approvals.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceAllows programmatic management of a Dify instance, including listing and creating datasets, managing applications, and tool providers.-
- FlicenseNot gradedqualityDmaintenanceEnables programmatic management of a Dify instance, including datasets, apps, and tools.-
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Vercel API to manage deployments, domains, projects, and environment variables.MIT
- AlicenseBqualityDmaintenanceEnables automated deployments, environment management, snapshots, and deployment monitoring through DevOps Deploy's REST API.1513 npmMIT