argocd-mcp

Argo CD MCP 服务器

Argo CD的模型上下文协议 (MCP)服务器实现，使 AI 助手能够通过自然语言与您的 Argo CD 应用程序交互。该服务器允许通过 stdio 和服务器发送事件 (SSE) 传输协议与 Visual Studio Code 和其他 MCP 客户端无缝集成。

该项目由 Argo 项目的创建者Akuity维护。

Akuity 是 Argo 和 Kargo 的企业级公司，为 Kubernetes 提供端到端 GitOps 的核心平台。借助 Akuity 平台，企业可以使用托管的 Argo CD 进行部署，与 Kargo 无缝集成，并使用 Akuity 监控功能实时洞察其基础架构。Akuity 由 Argo 创始人 Hong Wang、Jesse Suen 和 Alexander Matyushentsev 创立，其使命是为平台和应用程序团队提供企业级 GitOps 的最佳工具。

特征

• 传输协议：支持 stdio 和 SSE 传输模式，可灵活地与不同的客户端集成
• 完整的 Argo CD API 集成：提供对 Argo CD 资源和操作的全面访问
• AI 助手就绪：预先配置的工具，供 AI 助手以自然语言与 Argo CD 进行交互

安装

先决条件

• Node.js（建议使用 v18 或更高版本）
• pnpm 包管理器（用于开发）
• 具有 API 访问权限的 Argo CD 实例
• Argo CD API 令牌（请参阅文档了解说明）

与游标一起使用

1. 按照Cursor 文档获取 MCP 支持，并在项目中创建.cursor/mcp.json文件：

2. 开始与代理模式对话以使用 MCP。

与 VSCode 一起使用

1. 按照VS Code 文档中的使用 MCP 服务器，在您的项目中创建一个.vscode/mcp.json文件：

2. 在支持 MCP 的 VS Code 中与 AI 助手开始对话。

与 Claude Desktop 一起使用

1. 按照Claude Desktop 文档中的 MCP创建一个claude_desktop_config.json配置文件：

2. 在设置中配置 Claude Desktop 以使用此配置文件。

可用工具

该服务器提供以下ArgoCD管理工具：

应用程序管理

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

资源管理

• get_application_resource_tree ：获取特定应用程序的资源树
• get_application_managed_resources ：获取特定应用程序的托管资源
• get_application_workload_logs ：获取应用程序工作负载（Pod、部署等）的日志
• get_resource_events ：获取应用程序管理的资源的事件
• get_resource_actions ：获取资源可用的操作
• run_resource_action ：对资源运行操作

为了发展

1. 克隆存储库：

2. 安装项目依赖项：

3. 启动开发服务器并启用热重载：

一旦服务器运行，您就可以在 Visual Studio Code 或其他 MCP 客户端中使用 MCP 服务器。

升级 ArgoCD 类型

要根据最新的 Argo CD API 规范更新 TypeScript 类型定义：

1. 从ArgoCD 发布页面下载swagger.json文件，例如这里是 ArgoCD v2.14.11 的swagger.json 链接。
2. 将下载的swagger.json文件放在argocd-mcp项目的根目录中。
3. 运行以下命令，从 Swagger 定义生成 TypeScript 类型。这将创建或覆盖src/types/argocd.d.ts文件：
   pnpm run generate-types
4. 更新src/types/argocd-types.ts文件，从新生成的src/types/argocd.d.ts中导出所需的类型。此步骤通常需要手动检查，以确保仅公开必要的类型。