ArgoCD MCP Server

A Model Context Protocol (MCP) server that provides ArgoCD functionality as tools for LLMs via gRPC API.

Features

Application Management

• list_application - List ArgoCD applications with optional filtering by project, cluster, namespace, and label selectors
• get_application - Retrieve detailed information about a specific ArgoCD application
• get_application_manifests - Get rendered Kubernetes manifests for an application
• get_application_events - Get Kubernetes events for resources belonging to an application
• get_application_logs - Retrieve logs from pods in an ArgoCD application
• get_application_resource_tree - Get the resource tree structure of an application showing all managed resources
• create_application - Create a new ArgoCD application with source and destination configuration
• sync_application - Trigger a sync operation for an application with optional prune and dry-run modes
• refresh_application - Refresh application state from the git repository
• delete_application - Delete an ArgoCD application with optional cascade control
• terminate_operation - Terminate the currently running operation (sync, refresh, etc.) on an application

ApplicationSet Management

• list_applicationset - List ArgoCD ApplicationSets with optional filtering
• get_applicationset - Retrieve detailed information about a specific ApplicationSet
• create_applicationset - Create a new ApplicationSet with generators and templates
• delete_applicationset - Delete an ApplicationSet with cascade control

Project Management

• list_project - List all ArgoCD projects
• get_project - Retrieve detailed project information by name
• create_project - Create new ArgoCD project with access controls and deployment restrictions

Cluster Management

• list_cluster - List all registered clusters in ArgoCD
• get_cluster - Retrieve detailed cluster information including configuration and status

Repository Management

• list_repository - List all configured Git repositories
• get_repository - Get details of a specific repository including connection status

Prerequisites

• Go 1.21+
• Access to an ArgoCD server with API token

Installation

go build -o argocd-mcp-server ./cmd/argocd-mcp-server

Configuration

Set the following environment variables:

export ARGOCD_AUTH_TOKEN=$(argocd account generate-token)
export ARGOCD_SERVER=your-argocd-server.com:443  # Include port number

# Optional settings
export ARGOCD_INSECURE=false     # Skip TLS verification (default: false)
export ARGOCD_PLAINTEXT=false    # Use plaintext connection (default: false)
export ARGOCD_GRPC_WEB=false     # Enable gRPC-Web proxy mode (default: false)
export ARGOCD_GRPC_WEB_ROOT_PATH=""  # Custom root path for gRPC-Web requests (optional)

# Logging configuration
export LOG_LEVEL=info     # Options: debug, info, warn, error
export LOG_FORMAT=text    # Options: text, json

Usage

Run the server:

./argocd-mcp-server

The server communicates via stdin/stdout using the MCP protocol.

Testing

List available tools:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | ./argocd-mcp-server

Tool Examples

List Applications

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "list_application",
    "arguments": {
      "project": "default"
    }
  }
}

Get Application Details

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_application",
    "arguments": {
      "name": "my-app"
    }
  }
}

Get Application Manifests

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "get_application_manifests",
    "arguments": {
      "name": "my-app",
      "revision": "main"
    }

... [View full README on GitHub](https://github.com/toyamagu-2021/argocd-mcp-server#readme)