# Argo Workflow MCP Server

一个 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 服务器，为 AI Agent 提供管理 Argo Workflows 的能力。

## 功能特性

- 🚀 通过 Argo Server REST API 管理 Argo Workflows
- 📝 创建、查询、列出和删除 Workflow Templates
- ⚡ 提交、监控和管理 Workflow 实例
- 🔒 支持 Token 认证和 TLS 证书验证
- 🛠️ 完整的 MCP 协议支持
- 📦 易于安装和配置

## 安装

### 使用 npx（推荐）

无需安装，直接运行：

```bash
npx argo-workflow-mcp-server --argo-server https://argo-server.example.com --argo-token your-token
```

### 全局安装

```bash
npm install -g argo-workflow-mcp-server
```

## 使用方法

### 命令行参数

```bash
argo-workflow-mcp-server [options]

选项：
  --argo-server <url>      Argo Server 地址（必需）
  --argo-token <token>     Argo Server 认证 token（可选）
  --argo-insecure          跳过 TLS 证书验证（用于自签名证书或开发环境）
  --namespace <name>       默认命名空间（默认：argo）
  --log-level <level>      日志级别：error, warn, info, debug（默认：info）
  -h, --help               显示帮助信息
  -V, --version            显示版本号
```

### 示例

#### 连接到生产环境 Argo Server

```bash
argo-workflow-mcp-server \
  --argo-server https://argo-server.example.com \
  --argo-token your-auth-token \
  --namespace argo
```

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

首先设置 port-forward：

```bash
kubectl port-forward -n argo svc/argo-server 2746:2746
```

然后启动 MCP Server：

```bash
argo-workflow-mcp-server \
  --argo-server http://localhost:2746 \
  --argo-insecure \
  --namespace argo
```

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

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

```bash
argo-workflow-mcp-server \
  --argo-server https://argo-server.example.com \
  --argo-token your-auth-token \
  --argo-insecure \
  --namespace argo
```

**注意**：`--argo-insecure` 会跳过 TLS 证书验证，仅在以下情况使用：
- 开发和测试环境
- 使用自签名证书的内部环境
- 通过 port-forward 连接本地环境

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

## AI Agent 配置

### Kiro

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

```json
{
  "mcpServers": {
    "argo-workflow": {
      "command": "npx",
      "args": [
        "-y",
        "argo-workflow-mcp-server",
        "--argo-server",
        "https://argo-server.example.com",
        "--argo-token",
        "your-auth-token",
        "--namespace",
        "argo"
      ]
    }
  }
}
```

### 其他 MCP 客户端

参考 [MCP 文档](https://modelcontextprotocol.io) 配置您的客户端。

## 可用工具

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：

```bash
kubectl get svc -n argo argo-server
```

如果使用 port-forward：

```bash
kubectl port-forward -n argo svc/argo-server 2746:2746
# 然后使用 http://localhost:2746
```

### 获取认证 Token

创建 ServiceAccount 并获取 token：

```bash
# 创建 ServiceAccount
kubectl create sa argo-workflow-mcp -n argo

# 创建 RoleBinding（根据需要调整权限）
kubectl create rolebinding argo-workflow-mcp \
  --clusterrole=argo-admin \
  --serviceaccount=argo:argo-workflow-mcp \
  -n argo

# 获取 token
kubectl create token argo-workflow-mcp -n argo --duration=8760h
```

## 开发

### 构建

```bash
npm install
npm run build
```

### 测试

```bash
npm test
```

### 本地测试

```bash
npm run build
npm link
argo-workflow-mcp-server --help
```

## 故障排查

### 自签名证书错误

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

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

```bash
argo-workflow-mcp-server \
  --argo-server https://your-argo-server \
  --argo-token your-token \
  --argo-insecure
```

### 连接失败

- 确认 Argo Server 地址正确
- 检查网络连接
- 验证 token 是否有效
- 如果使用 HTTPS，确保证书有效或使用 `--argo-insecure`

### 权限错误

- 确认 ServiceAccount 有足够的权限
- 检查 RBAC 配置
- 验证 token 是否过期

### 更多帮助

查看 [故障排查指南](./docs/TROUBLESHOOTING.md)

## 许可证

MIT License - 详见 [LICENSE](./LICENSE) 文件

## 贡献

欢迎提交 Issue 和 Pull Request！

## 相关链接

- [Argo Workflows](https://argoproj.github.io/workflows/)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [Kiro IDE](https://kiro.ai)