ArgoCD MCP 服务器

安装

克隆仓库

git clone https://github.com/akuity/argocd-mcp.git
cd argocd-mcp

安装项目依赖

pnpm install

启动开发服务器（带热重载）

# 使用 SSE 模式并启用热重载
pnpm run dev

启动后，可以在 Visual Studio Code 或其他 MCP 客户端中使用此服务器。

配置

使用 Cursor

1. 参考 Cursor 文档中的 MCP 支持，创建项目目录下的 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

2. 使用 Agent 模式启动会话。

使用 Visual Studio Code

1. 参考 VSCode 中 MCP 支持的文档，创建项目目录下的 .vscode/mcp.json 文件：

{
  "servers": {
    "argocd-mcp-stdio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

2. 在支持 MCP 的 VS Code 中启动会话。

使用 Claude Desktop

1. 参考 Claude Desktop 文档中的 MCP 支持，创建配置文件 claude_desktop_config.json：

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

2. 在 Claude Desktop 设置中指定此配置文件。

可用工具

应用管理

• list_applications：列出并过滤所有应用
• get_application：获取特定应用的详细信息
• create_application：创建新应用
• update_application：更新现有应用
• delete_application：删除应用
• sync_application：触发应用同步

资源管理

• get_application_resource_tree：获取特定应用的资源树
• get_application_managed_resources：获取应用管理的资源
• get_application_deployment：获取应用的部署信息
• update_application_deployment：更新应用的部署配置

更新 ArgoCD 依赖项

要更新项目中的 argocd 依赖项到最新版本，请运行：

pnpm update argocd

重新构建项目

pnpm build

提交代码

git add .
git commit -m "your_commit_message"
git push

术语表

• MCP：Model Context Protocol（模型上下文协议）
• ArgoCD：一个用于应用交付和管理的工具