Argo Workflow MCP Server

一个 Model Context Protocol (MCP) 服务器，为 AI Agent 提供管理 Argo Workflows 的能力。

功能特性

• 🚀 通过 Argo Server REST API 管理 Argo Workflows

• 📝 创建、查询、列出和删除 Workflow Templates

• ⚡ 提交、监控和管理 Workflow 实例

• 🔒 支持 Token 认证和 TLS 证书验证

• 🛠️ 完整的 MCP 协议支持

• 📦 易于安装和配置

安装

使用 npx（推荐）

无需安装，直接运行：

全局安装

使用方法

命令行参数

示例

连接到生产环境 Argo Server

连接到本地开发环境（通过 port-forward）

首先设置 port-forward：

然后启动 MCP Server：

连接到使用自签名证书的 Argo Server

如果你的 Argo Server 使用自签名证书，会遇到 "self-signed certificate" 错误。使用 --argo-insecure 参数跳过证书验证：

注意：--argo-insecure 会跳过 TLS 证书验证，仅在以下情况使用：

• 开发和测试环境

• 使用自签名证书的内部环境

• 通过 port-forward 连接本地环境

不推荐在生产环境使用，生产环境应使用有效的 TLS 证书。

AI Agent 配置

Kiro

在 .kiro/settings/mcp.json 中添加配置：

其他 MCP 客户端

参考 MCP 文档 配置您的客户端。

可用工具

MCP Server 提供以下工具：

Workflow Template 管理

• create_workflow_template - 创建新的 Workflow Template

• get_workflow_template - 查询指定的 Workflow Template

• list_workflow_templates - 列出所有 Workflow Templates

• delete_workflow_template - 删除指定的 Workflow Template

Workflow 实例管理

• submit_workflow - 从模板提交新的 Workflow

• get_workflow_status - 查询 Workflow 运行状态

• list_workflows - 列出所有 Workflows

• delete_workflow - 删除指定的 Workflow

获取 Argo Server 地址和 Token

获取 Argo Server 地址

如果 Argo Server 已暴露为 LoadBalancer 或 Ingress：

如果使用 port-forward：

获取认证 Token

创建 ServiceAccount 并获取 token：

开发

构建

测试

本地测试

故障排查

自签名证书错误

错误信息：Failed to connect to Argo Server: self-signed certificate

解决方案：使用 --argo-insecure 参数跳过 TLS 证书验证

连接失败

• 确认 Argo Server 地址正确

• 检查网络连接

• 验证 token 是否有效

• 如果使用 HTTPS，确保证书有效或使用 --argo-insecure

权限错误

• 确认 ServiceAccount 有足够的权限

• 检查 RBAC 配置

• 验证 token 是否过期

更多帮助

查看 故障排查指南

许可证

MIT License - 详见 LICENSE 文件

贡献

欢迎提交 Issue 和 Pull Request！

相关链接

• Argo Workflows

• Model Context Protocol

• Kiro IDE