argoproj-labs/mcp-for-argocd

An implementation of Model Context Protocol (MCP) server for Argo CD, enabling AI assistants to interact with your Argo CD applications through natural language. This server allows for seamless integration with Visual Studio Code and other MCP clients through stdio and HTTP stream transport protocols.
",
"ARGOCDAPITOKEN": " "
});
const urlForWebsites = vscode:mcp/install?${encodeURIComponent(config)};
// Github markdown does not allow linking to vscode: directly, so you can use our redirect:
const urlForGithub = https://insiders.vscode.dev/redirect?url=${encodeURIComponent(urlForWebsites)};
## Features
Transport Protocols: Supports both stdio and HTTP stream transport modes for flexible integration with different clients
Complete Argo CD API Integration: Provides comprehensive access to Argo CD resources and operations
AI Assistant Ready: Pre-configured tools for AI assistants to interact with Argo CD in natural language
## Available Tools
The server provides the following ArgoCD management tools:
### Cluster Management
listclusters: List all clusters registered with ArgoCD
### Project Management
getappproject: Get detailed information about a specific AppProject (project)
### Application Management
listapplications: List and filter all applications
getapplication: Get detailed information about a specific application
getapplicationevents: Get events for a specific application
createapplication: Create a new application
updateapplication: Update an existing application
deleteapplication: Delete an application
syncapplication: Trigger a sync operation on an application
### Resource Management
getapplicationresourcetree: Get the resource tree for a specific application
getapplicationmanagedresources: Get managed resources for a specific application
getresources: Get manifests for resources managed by an application
getapplicationworkloadlogs: Get logs for application workloads (Pods, Deployments, etc.)
getresourceevents: Get events for resources managed by an application
getresourceactions: Get available actions for resources
runresourceaction: Run an action on a resource
## Installation
### Prerequisites
Node.js (v18 or higher recommended)
pnpm package manager (for development)
Argo CD instance with API access
Argo CD API token (see the docs for instructions)
### Usage with Cursor
1. Follow the Cursor documentation for MCP support, and create a .cursor/mcp.json file in your project:
json
"mcpServers": {
"argocd-mcp": {
"command": "npx",
"args": [
"argocd-mcp@latest",
"stdio"
],
"env": {
"ARGOCDBASEURL": " ",
"ARGOCDAPITOKEN": " "
2. Start a conversation with Agent mode to use the MCP.
### Usage with VSCode
1. Follow the Use MCP servers in VS Code documentation, and create a .vscode/mcp.json file in your project:
json
"servers": {
"argocd-mcp-stdio": {
"type": "stdio",
"command": "npx",
"args": [
"argocd-mcp@latest",
"stdio"
],
"env": {
"ARGOCDBASEURL": " ",
"ARGOCDAPITOKEN": " "
2. Start a conversation with an AI assistant in VS Code that supports MCP.
### Usage with Claude Desktop
1. Follow the MCP in Claude Desktop documentation, and create a claudedesktopconfig.json configuration file:
json
"mcpServers": {
"argocd-mcp": {
"command": "npx",