mcp-for-argocd
by argoproj-labs·★ 464·Score 53
MCP server enabling AI assistants to interact with Argo CD applications through natural language.
Overview
This is a robust MCP server implementation for Argo CD that provides comprehensive access to Argo CD resources and operations through natural language interactions. It supports both stdio and HTTP stream transport protocols, making it compatible with various MCP clients. The server implements tools for cluster management, application lifecycle management, and resource management, allowing AI assistants to perform operations like listing applications, syncing deployments, and retrieving logs.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose this server if you're using Argo CD for Kubernetes application delivery and want AI assistants to manage applications through natural language commands.
When NOT to choose this
Don't choose this if you need access to other GitOps tools like Flux or if your Argo CD instance lacks API access tokens for authentication.
Tools this server exposes
12 tools extracted from the READMElist_clustersList all clusters registered with ArgoCD
list_applicationsList and filter all applications
get_applicationGet detailed information about a specific application
create_applicationCreate a new application
update_applicationUpdate an existing application
delete_applicationDelete an application
sync_applicationTrigger a sync operation on an application
get_application_resource_treeGet the resource tree for a specific application
get_application_managed_resourcesGet managed resources for a specific application
get_application_workload_logsGet logs for application workloads
get_resource_eventsGet events for resources managed by an application
run_resource_actionRun an action on a resource
Comparable tools
Installation
Installation
Prerequisites
- Node.js (v18 or higher recommended)
- Argo CD instance with API access
- Argo CD API token
Usage with Claude Desktop
- Create a
claude_desktop_config.jsonconfiguration file:
{
"mcpServers": {
"argocd-mcp": {
"command": "npx",
"args": [
"argocd-mcp@latest",
"stdio"
],
"env": {
"ARGOCD_BASE_URL": "<argocd_url>",
"ARGOCD_API_TOKEN": "<argocd_token>"
}
}
}
}- Configure Claude Desktop to use this configuration file in settings.
Usage with VSCode
- Create a
.vscode/mcp.jsonfile in your project:
{
"servers": {
"argocd-mcp-stdio": {
"type": "stdio",
"command": "npx",
"args": [
"argocd-mcp@latest",
"stdio"
],
"env": {
"ARGOCD_BASE_URL": "<argocd_url>",
"ARGOCD_API_TOKEN": "<argocd_token>"
}
}
}
}- Start a conversation with an AI assistant in VS Code that supports MCP.
FAQ
- Does this server support self-signed certificates?
- Yes, you can set the environment variable NODE_TLS_REJECT_UNAUTHORIZED=0 to disable TLS certificate validation for self-signed certificates or certificates from private CAs. Note that this reduces security and should only be used in development or when you understand the security implications.
- Can I run the server in read-only mode?
- Yes, set the environment variable MCP_READ_ONLY=true to disable resource or application modification tools like create_application, update_application, delete_application, sync_application, and run_resource_action.
Compare mcp-for-argocd with
Last updated · Auto-generated from public README + GitHub signals.