Argocd MCP

🚀 ArgoCD MCP 服務器

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：一個用於應用交付和管理的工具