项目简介

Argo CD MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端实现，它允许人工智能助手（如VS Code Copilot, Cursor, Claude Desktop等）通过自然语言与您的Argo CD应用进行交互和管理。通过集成Argo CD的API，它将Argo CD的应用和资源信息作为上下文提供给AI，并允许AI调用工具执行管理操作。

主要功能点

它提供以下主要功能：

• 应用管理： 通过AI助手列出、获取详细信息、创建、更新、删除和同步Argo CD中的应用。
• 资源访问： 获取应用关联的Kubernetes资源树、管理资源列表、查看应用和资源日志、获取资源事件等。
• 资源操作： 获取并执行特定Kubernetes资源上可用的操作，例如重启一个Pod或回滚一个Deployment。
• 多种传输方式： 支持通过标准输入输出 (Stdio) 和 Server-Sent Events (SSE) 与客户端通信，方便集成到不同的AI助手和开发环境中。

安装步骤

开始使用此MCP服务器前，请确保已安装：

• Node.js (推荐 v18 或更高版本)
• 一个可访问API的Argo CD实例，并已获取API访问凭据（通常是API Token）。

服务器本身无需像传统服务一样进行复杂安装，通常通过兼容MCP的AI客户端按需启动。您只需要在客户端配置中指定启动命令。

服务器配置

为了让支持MCP的客户端（如VS Code、Cursor、Claude Desktop等）连接到此服务器，您需要在客户端的MCP配置文件中添加服务器配置。配置通常为JSON格式，至少包含以下信息：

• 服务器名称 (name)： 一个用于标识此MCP服务器的唯一名称，例如 "argocd-mcp"。
• 启动命令 (command)： 客户端将执行的命令，通常是 'npx' 结合包名，例如 'npx'。
• 命令参数 (args)： 传递给启动命令的参数，用于指定传输协议（如 'stdio' 或 'sse' 加上端口号）和服务器版本，例如 '["argocd-mcp@latest", "stdio"]'。
• 环境变量 (env)： 启动服务器进程时需要设置的环境变量，用于提供Argo CD的连接信息。至少需要 'ARGOCD_BASE_URL' (Argo CD API的基础URL) 和 'ARGOCD_API_TOKEN' (用于认证的API Token)。

客户端会根据您提供的配置在需要时启动服务器进程并建立通信。

基本使用方法

1. 根据您的AI客户端文档，将此MCP服务器的配置信息添加到客户端的MCP配置文件中。
2. 在配置中填入您的Argo CD实例的基础URL和API Token。
3. 在客户端中打开AI助手聊天界面。
4. 像与人交流一样，用自然语言向AI助手提出关于Argo CD应用的问题或请求。例如：
   • "列出所有Argo CD应用"
   • "查看应用 'my-app' 的详细信息"
   • "同步应用 'frontend-app'"
   • "获取应用 'backend-service' 的Pod日志"
5. AI助手将解析您的请求，并调用此MCP服务器提供的相应工具来执行操作或获取信息。结果将通过聊天界面返回给您。