
Argocd
io.github.asklokesh由 GitHub 账号 asklokesh 发布v0.1.0更新于 Oct 24, 2026
MCP server for ArgoCD GitOps continuous delivery integration
概览
一个连接 ArgoCD 的 MCP 服务器,让 AI 助手管理 GitOps 应用、项目、仓库、集群和同步操作。
- 可以做什么
- 列出、创建、同步、回滚和删除 ArgoCD 应用,并读取其状态与健康情况。创建和配置项目、角色与策略。添加或移除 Git 与 Helm 仓库,注册 Kubernetes 集群。创建 ApplicationSet 以实现基于模板的多集群部署。查看应用健康、同步状态和资源树。
- 适用场景
- 当你使用 ArgoCD 进行 Kubernetes GitOps 交付,并希望助手通过对话查看部署状态、触发或回滚同步、配置项目、仓库和集群,而不必操作 ArgoCD 界面或命令行时适用。
- 运行要求
- 以 Python 包形式在本地运行(pip 或 uvx)。需要能访问 ArgoCD 服务器的网络、其 API 地址,以及通过环境变量提供的 API 密钥;README 还列出服务器地址、认证令牌和可选的 TLS 证书设置。仅限桌面客户端。
安装
在 SourceWeft 中
- 打开 控制台中的 Argocd,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
ArgoCD MCP Server
Argocd Mcp Server
[GitHub stars] [GitHub forks] [GitHub watchers]
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
Or install from source:
Configuration
Create a .env file or set environment variables:
Quick Start
Basic Usage
Claude Desktop Configuration
Add to your Claude Desktop config:
Available Tools
Application Management
List Applications
Create Application
Sync Application
Get Application Status
Rollback Application
Project Management
Create Project
Repository Management
Add Repository
Add Helm Repository
Cluster Management
Add Cluster
Application Sets
Create ApplicationSet
Health and Monitoring
Get Application Health
Get Resource Tree
Advanced Configuration
Multi-Cluster GitOps
Progressive Delivery
Disaster Recovery
Integration Examples
See the examples/ directory for complete integration examples:
basic_gitops.py- Basic GitOps workflowsmulti_cluster_deployment.py- Multi-cluster application deploymentprogressive_delivery.py- Canary and blue-green deploymentsdisaster_recovery.py- Backup and restore workflowsgenai_gitops.py- AI-powered GitOps automationsecurity_scanning.py- Integration with security tools
Security Best Practices
- Use service accounts with minimal permissions
- Enable RBAC with proper policies
- Implement network policies for cluster isolation
- Use sealed secrets or external secret operators
- Enable audit logging for compliance
- Implement admission controllers for policy enforcement
- Regular security scanning of images and manifests
Error Handling
The server provides detailed error information:
Performance Optimization
- Use application sets for similar apps
- Enable resource caching in ArgoCD
- Implement sync windows to control deployment times
- Use webhook notifications instead of polling
- Optimize manifest generation with Helm/Kustomize
Troubleshooting
Common Issues
-
Sync failures
- Check application logs
- Verify repository access
- Review resource quotas
-
Authentication errors
- Verify token validity
- Check RBAC policies
- Review server connectivity
-
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版本历史
1- v0.1.0最新Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。