ArgoCD MCP 服务器

解决什么问题

在 Kubernetes 上交付数据库集群时，最常见的痛点不是镜像拉不下来，而是「集群状态」和「Git 仓库里的声明」逐渐脱节：有人直接 kubectl apply 改了一只 StatefulSet，Git 里没留痕，下次回滚无从下手；多人协作时，谁动了哪个参数根本查不清。Argo CD 用 GitOps 模式把这个问题收敛为一条规则：Git 仓库是唯一事实来源，集群状态由控制器持续比对、自动收敛。

但这套流程对 AI Agent 来说并不友好。Agent 通常没有终端会话，也不熟悉 argocd app sync、argocd app list 这一串 CLI 调用。ArgoCD MCP 服务器的价值在于，把 Argo CD 的操作封装成 Agent 可以直接调用的工具接口，让模型能「看」到应用状态、发起同步、查询部署进度，而不需要人去翻文档。

核心能力与工作方式

该技能围绕两条主线展开：

• 数据库集群在 Kubernetes 中的运行：以 Couchbase 为例，讲解如何用 Argo CD 管理有状态数据库的部署——包括 StatefulSet、Service、PersistentVolumeClaim 等资源如何组织进 Git 仓库，Argo CD 如何按顺序滚动更新，以及数据库就绪探针与应用同步节奏如何配合，避免 pod 起来了但服务还没准备好。
• GitOps 部署入门：从零梳理 Argo CD 的基本工作流：安装控制器、配置仓库凭据、创建 Application CR、理解 Sync 与 Health 两个状态维度，以及日常排障时看哪些字段。

技能内容提取自 Argo CD 上游官方文档，并经过整理，保留工程实践中真正用得到的步骤，而不是照搬全部配置项。

适用边界与注意点

• 技能侧重应用部署与状态同步，不涉及 Couchbase 的数据备份、扩容调优等运维深水区，这些仍需参考数据库官方文档。
• Argo CD 负责「让集群趋近期望状态」，但不会自动处理迁移类变更（如 Schema 升级），这类步骤需要写进部署脚本或单独流程。
• 凭据管理、仓库权限隔离属于前置条件，技能不会覆盖你的安全基线。
• 官方文档迭代较快，遇到行为差异时优先对照 Argo CD 文档站 核实版本差异。