argocd-mcp 的安装和配置教程

2025-05-24 09:56:11作者：昌雅子Ethen

项目基础介绍

argocd-mcp 是一个实现了模型上下文协议（Model Context Protocol, MCP）的服务器，专门为 Argo CD 设计。它允许 AI 助手通过自然语言与 Argo CD 应用进行交互。此项目支持与 Visual Studio Code 和其他 MCP 客户端的无缝集成，通过标准输入输出（stdio）和 HTTP 流传输协议进行通信。该项目主要由 TypeScript 语言编写。

项目使用的关键技术和框架

本项目主要使用了以下技术和框架：

Node.js：运行环境，用于执行后端服务。
TypeScript：静态类型语言的超集，为 JavaScript 提供了类型系统和对 ES6 的支持。
Model Context Protocol (MCP)：允许客户端与 AI 助手进行交互的协议。
Argo CD API：与 Argo CD 进行交互的接口。

安装和配置准备工作

在开始安装 argocd-mcp 之前，请确保您的系统中已经安装以下必要的软件：

Node.js（推荐版本 v18 或更高）
pnpm 包管理器（用于开发）
Argo CD 实例以及 API 访问权限
Argo CD API 令牌（查看文档获取指令）

安装步骤

以下是详细的安装步骤：

克隆项目仓库

使用 Git 命令克隆项目仓库到本地：

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

安装项目依赖

在项目根目录下，使用 pnpm 安装项目依赖：
```
pnpm install
```
启动开发服务器

运行以下命令启动开发服务器，并开启热重载功能：
```
pnpm run dev
```

配置 MCP 服务器

根据您使用的客户端（如 Cursor、VSCode 或 Claude Desktop），在项目根目录下创建相应的配置文件，并设置 Argo CD 的基础 URL 和 API 令牌。

对于 Cursor，创建 cursor/mcp.json 文件：

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

对于 VSCode，创建 .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>"
      }
    }
  }
}

对于 Claude Desktop，创建 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>"
      }
    }
  }
}

替换 <argocd_url> 和 <argocd_token> 为您的 Argo CD 实例的 URL 和 API 令牌。

使用自签名证书

如果您的 Argo CD 实例使用自签名证书或来自私有证书颁发机构的证书，您可能需要在配置中添加以下环境变量以禁用 TLS 证书验证：
```
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
```
注意：禁用 SSL 验证会降低安全性。仅在开发环境中使用此设置，或者当您了解安全影响时使用。