Argocd MCP

🚀 ArgoCD MCP Server

The ArgoCD MCP Server is a tool that enables seamless integration with various development environments, providing efficient application management and resource management capabilities.

🚀 Quick Start

📦 Installation

Clone the repository

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

Install project dependencies

pnpm install

Start the development server (with hot reloading)

# Use SSE mode and enable hot reloading
pnpm run dev

After starting, you can use this server in Visual Studio Code or other MCP clients.

⚙️ Configuration

Using Cursor

1. Refer to MCP Support in Cursor Documentation to create a .cursor/mcp.json file in the project directory:

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

2. Start a session in Agent mode.

Using Visual Studio Code

1. Refer to Documentation for MCP Support in VSCode to create a .vscode/mcp.json file in the project directory:

{
  "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. Start a session in a VS Code that supports MCP.

Using Claude Desktop

1. Refer to MCP Support in Claude Desktop Documentation to create a configuration file 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. Specify this configuration file in the Claude Desktop settings.

🛠️ Available Tools

Application Management

• list_applications: List and filter all applications
• get_application: Get detailed information about a specific application
• create_application: Create a new application
• update_application: Update an existing application
• delete_application: Delete an application
• sync_application: Trigger application synchronization

Resource Management

• get_application_resource_tree: Get the resource tree of a specific application
• get_application_managed_resources: Get the resources managed by an application
• get_application_deployment: Get the deployment information of an application
• update_application_deployment: Update the deployment configuration of an application

🔄 Update ArgoCD Dependencies

To update the argocd dependencies in the project to the latest version, run:

pnpm update argocd

🔨 Rebuild the Project

pnpm build

📤 Submit Code

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

📚 Glossary

• MCP: Model Context Protocol
• ArgoCD: A tool for application delivery and management