Argocd

io.github.asklokesh由 GitHub 帳號 asklokesh 發布v0.1.0更新於 Oct 24, 2026

MCP server for ArgoCD GitOps continuous delivery integration

概覽

AI 產生的概覽

一個連接 ArgoCD 的 MCP 伺服器,讓 AI 助理管理 GitOps 應用程式、專案、儲存庫、叢集與同步作業。

可以做什麼
列出、建立、同步、回復和刪除 ArgoCD 應用程式,並讀取其狀態與健康情況。建立與設定專案、角色及原則。新增或移除 Git 與 Helm 儲存庫,註冊 Kubernetes 叢集。建立 ApplicationSet 以進行範本化的多叢集部署。檢視應用程式健康、同步狀態與資源樹。
適用情境
當你使用 ArgoCD 進行 Kubernetes GitOps 交付,並希望助理透過對話檢視部署狀態、觸發或回復同步、設定專案、儲存庫與叢集,而不必操作 ArgoCD 介面或命令列時適用。
執行需求
以 Python 套件形式在本機執行(pip 或 uvx)。需要能連線至 ArgoCD 伺服器的網路、其 API 位址,以及透過環境變數提供的 API 金鑰;README 另列出伺服器位址、驗證權杖與選用的 TLS 憑證設定。僅限桌面用戶端。
安裝前請注意
此 API 金鑰可存取持續交付系統:工具能建立、同步、回復和刪除應用程式,修改專案與 RBAC,並註冊叢集,誤操作可能變更或刪除執行中的 Kubernetes 工作負載。儲存庫與叢集相關工具需要 Git 密碼、叢集 bearer token 等憑證。建議使用最小權限的服務帳號,並在確認前檢查操作。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Argocd,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

ArgoCD MCP Server

A Model Context Protocol (MCP) server for integrating ArgoCD GitOps continuous delivery tool with GenAI applications, enabling intelligent Kubernetes deployment management.

Features

  • Comprehensive ArgoCD API Coverage:

    • Application Management: Create, sync, delete, rollback applications
    • Project Management: Configure projects, roles, and policies
    • Repository Management: Add/remove Git repositories, Helm charts
    • Cluster Management: Register and manage Kubernetes clusters
    • Sync Operations: Manual/auto sync, sync windows, hooks
    • Health Monitoring: Application health, sync status, resource tree
    • RBAC Management: Users, roles, policies, JWT tokens
    • GitOps Workflows: Automated deployments from Git commits
    • Multi-tenancy: Namespace isolation, project restrictions
    • Application Sets: Template-based multi-cluster deployments
  • Authentication Methods:

    • JWT Token authentication
    • API Token authentication
    • OIDC/OAuth2 integration
    • LDAP authentication support
  • Enterprise Features:

    • Multi-cluster support
    • Disaster recovery workflows
    • Progressive delivery (Canary, Blue-Green)
    • Automated rollback on failures
    • Audit logging and compliance
    • Resource optimization
    • Secret management integration

Installation

bash
pip install argocd-mcp-server

Or install from source:

bash
git clone https://github.com/asklokesh/argocd-mcp-server.gitcd argocd-mcp-serverpip install -e .

Configuration

Create a .env file or set environment variables:

env
# ArgoCD ConnectionARGOCD_SERVER=argocd.example.comARGOCD_AUTH_TOKEN=your_auth_tokenARGOCD_INSECURE=false
# Optional SettingsARGOCD_GRPC_WEB=trueARGOCD_TIMEOUT=30ARGOCD_CLIENT_CERT=/path/to/cert.pemARGOCD_CLIENT_KEY=/path/to/key.pem
# Multi-Cluster SupportARGOCD_PROD_SERVER=argocd-prod.example.comARGOCD_PROD_TOKEN=prod_token
ARGOCD_DEV_SERVER=argocd-dev.example.comARGOCD_DEV_TOKEN=dev_token

Quick Start

Basic Usage

python
from argocd_mcp import ArgoCDMCPServer
# Initialize the serverserver = ArgoCDMCPServer()
# Start the serverserver.start()

Claude Desktop Configuration

Add to your Claude Desktop config:

json
{  "mcpServers": {    "argocd": {      "command": "python",      "args": ["-m", "argocd_mcp.server"],      "env": {        "ARGOCD_SERVER": "argocd.example.com",        "ARGOCD_AUTH_TOKEN": "your_auth_token"      }    }  }}

Available Tools

Application Management

List Applications
python
{  "tool": "argocd_list_applications",  "arguments": {    "project": "default",    "namespace": "argocd"  }}
Create Application
python
{  "tool": "argocd_create_application",  "arguments": {    "name": "my-app",    "project": "default",    "source": {      "repoURL": "https://github.com/org/repo.git",      "path": "manifests",      "targetRevision": "main"    },    "destination": {      "server": "https://kubernetes.default.svc",      "namespace": "production"    },    "syncPolicy": {      "automated": {        "prune": true,        "selfHeal": true      }    }  }}
Sync Application
python
{  "tool": "argocd_sync_application",  "arguments": {    "name": "my-app",    "prune": true,    "force": false,    "strategy": {      "hook": {        "force": true      }    }  }}
Get Application Status
python
{  "tool": "argocd_get_application_status",  "arguments": {    "name": "my-app",    "refresh": true  }}
Rollback Application
python
{  "tool": "argocd_rollback_application",  "arguments": {    "name": "my-app",    "revision": "abc123"  }}

Project Management

Create Project
python
{  "tool": "argocd_create_project",  "arguments": {    "name": "production",    "description": "Production applications",    "sourceRepos": ["https://github.com/org/*"],    "destinations": [      {        "server": "https://kubernetes.default.svc",        "namespace": "prod-*"      }    ],    "clusterResourceWhitelist": [      {"group": "*", "kind": "*"}    ]  }}

Repository Management

Add Repository
python
{  "tool": "argocd_add_repository",  "arguments": {    "url": "https://github.com/org/repo.git",    "name": "my-repo",    "type": "git",    "username": "git-user",    "password": "git-token",    "insecure": false  }}
Add Helm Repository
python
{  "tool": "argocd_add_helm_repository",  "arguments": {    "url": "https://charts.example.com",    "name": "my-charts",    "type": "helm",    "username": "helm-user",    "password": "helm-password"  }}

Cluster Management

Add Cluster
python
{  "tool": "argocd_add_cluster",  "arguments": {    "name": "production-cluster",    "server": "https://k8s-prod.example.com",    "config": {      "bearerToken": "cluster-token",      "tlsClientConfig": {        "insecure": false,        "caData": "base64-encoded-ca"      }    }  }}

Application Sets

Create ApplicationSet
python
{  "tool": "argocd_create_applicationset",  "arguments": {    "name": "multi-cluster-app",    "generators": [      {        "clusters": {},        "selector": {          "matchLabels": {            "environment": "production"          }        }      }    ],    "template": {      "metadata": {        "name": "{{cluster}}-app"      },      "spec": {        "project": "default",        "source": {          "repoURL": "https://github.com/org/repo.git",          "path": "{{cluster}}"        },        "destination": {          "server": "{{server}}",          "namespace": "default"        }      }    }  }}

Health and Monitoring

Get Application Health
python
{  "tool": "argocd_get_application_health",  "arguments": {    "name": "my-app"  }}
Get Resource Tree
python
{  "tool": "argocd_get_resource_tree",  "arguments": {    "name": "my-app"  }}

Advanced Configuration

Multi-Cluster GitOps

python
from argocd_mcp import ArgoCDMCPServer, ClusterConfig
# Configure multiple ArgoCD instancesclusters = {    "production": ClusterConfig(        server="argocd-prod.example.com",        auth_token="prod_token",        default_namespace="argocd"    ),    "staging": ClusterConfig(        server="argocd-staging.example.com",        auth_token="staging_token",        default_namespace="argocd-staging"    ),    "development": ClusterConfig(        server="argocd-dev.example.com",        auth_token="dev_token",        default_namespace="argocd-dev"    )}
server = ArgoCDMCPServer(clusters=clusters, default_cluster="production")

Progressive Delivery

python
# Configure progressive delivery strategiesprogressive_config = {    "canary": {        "steps": [            {"setWeight": 10},            {"pause": {"duration": "5m"}},            {"setWeight": 30},            {"pause": {"duration": "5m"}},            {"setWeight": 50},            {"pause": {"duration": "5m"}},            {"setWeight": 100}        ]    },    "blueGreen": {        "activeService": "app-active",        "previewService": "app-preview",        "autoPromotionEnabled": false    }}
server = ArgoCDMCPServer(progressive_config=progressive_config)

Disaster Recovery

python
from argocd_mcp import ArgoCDMCPServer, DisasterRecoveryConfig
dr_config = DisasterRecoveryConfig(    backup_enabled=True,    backup_schedule="0 2 * * *",  # Daily at 2 AM    backup_location="s3://backups/argocd",    restore_priority=["production", "staging", "development"])
server = ArgoCDMCPServer(dr_config=dr_config)

Integration Examples

See the examples/ directory for complete integration examples:

  • basic_gitops.py - Basic GitOps workflows
  • multi_cluster_deployment.py - Multi-cluster application deployment
  • progressive_delivery.py - Canary and blue-green deployments
  • disaster_recovery.py - Backup and restore workflows
  • genai_gitops.py - AI-powered GitOps automation
  • security_scanning.py - Integration with security tools

Security Best Practices

  1. Use service accounts with minimal permissions
  2. Enable RBAC with proper policies
  3. Implement network policies for cluster isolation
  4. Use sealed secrets or external secret operators
  5. Enable audit logging for compliance
  6. Implement admission controllers for policy enforcement
  7. Regular security scanning of images and manifests

Error Handling

The server provides detailed error information:

python
try:    result = server.execute_tool("argocd_sync_application", {        "name": "my-app"    })except ArgoCDError as e:    print(f"ArgoCD error: {e.error_code} - {e.message}")    if e.error_code == "OutOfSync":        print("Application is out of sync")    elif e.error_code == "ComparisonError":        print("Error comparing application state")

Performance Optimization

  1. Use application sets for similar apps
  2. Enable resource caching in ArgoCD
  3. Implement sync windows to control deployment times
  4. Use webhook notifications instead of polling
  5. Optimize manifest generation with Helm/Kustomize

Troubleshooting

Common Issues

  1. Sync failures

    • Check application logs
    • Verify repository access
    • Review resource quotas
  2. Authentication errors

    • Verify token validity
    • Check RBAC policies
    • Review server connectivity
  3. Performance issues

    • Check ArgoCD server resources
    • Review application count
    • Optimize manifest size

Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests.

License

MIT License - see LICENSE file for details

來源:README.md,提交 05ac6d5

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。