Argo Workflows MCP

Argo工作流MCP服务器

用于与Argo工作流交互的模型上下文协议（MCP）服务器。该服务器使Claude Desktop和Claude Code能够直接管理和监控Argo工作流。

特性

• 列出并监控工作流
• 管理工作流模板
• 处理cron工作流
• 查询工作流状态和日志
• 使用可配置的权限执行工作流操作

建筑

# Build the application
./gradlew installDist

# Run tests
./gradlew test

使用Claude Desktop进行配置

将此添加到您的Claude Desktop MCP配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%/Claude/claude_desktop_config.json

使用 claude 命令行界面

claude mcp add --transport stdio argo-workflows \
  -- docker run -i --rm \
    -e ARGO_BASE_URL=http://host.docker.internal:2746 \
    -e ARGO_NAMESPACE=default \
    -e MCP_ALLOW_MUTATIONS=true \
    -e MCP_AUDIT_FILE=/app/logs/mcp-audit.log \
    -v "$HOME/.kube/config:/home/mcp/.kube/config:ro" \
    -v "$HOME/.argo-mcp-logs:/app/logs" \
    ghcr.io/heapy/argo-workflows-mcp:main

运行命令后，重新启动Claude Desktop，使其重新加载MCP列表。

使用Docker

{
  "mcpServers": {
    "argo-workflows": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "ARGO_BASE_URL=http://host.docker.internal:2746",
        "-e", "ARGO_NAMESPACE=default",
        "-e", "MCP_ALLOW_MUTATIONS=true",
        "-e", "MCP_AUDIT_FILE=/app/logs/mcp-audit.log",
        "-v", "/Users/your-user/.kube/config:/home/mcp/.kube/config:ro",
        "-v", "/Users/your-user/.argo-mcp-logs:/app/logs",
        "ghcr.io/heapy/argo-workflows-mcp:main"
      ]
    }
  }
}

使用Claude代码进行配置

将以下内容添加到您的Claude Code MCP配置文件中：

位置: ~/.config/claude-code/mcp_config.json

使用Docker

{
  "mcpServers": {
    "argo-workflows": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "ARGO_BASE_URL=http://host.docker.internal:2746",
        "-e", "ARGO_NAMESPACE=default",
        "-e", "MCP_ALLOW_MUTATIONS=true",
        "-e", "MCP_AUDIT_FILE=/app/logs/mcp-audit.log",
        "-v", "/Users/your-user/.kube/config:/home/mcp/.kube/config:ro",
        "-v", "/Users/your-user/.argo-mcp-logs:/app/logs",
        "ghcr.io/heapy/argo-workflows-mcp:main"
      ]
    }
  }
}

Docker使用

使用已发布的图像

图片由CI发布到GitHub容器注册表：

• ghcr.io/heapy/argo-workflows-mcp:main --最新版本从 main
• ghcr.io/heapy/argo-workflows-mcp: --每次提交不可变构建

docker run -it --rm \
  -e ARGO_BASE_URL=https://your-argo-server:2746 \
  -e ARGO_NAMESPACE=default \
  -e ARGO_TOKEN=$(cat ~/secrets/argo-token) \
  -e MCP_AUDIT_FILE=/app/logs/mcp-audit.log \
  -v /Users/your-user/.kube/config:/home/mcp/.kube/config:ro \
  -v /Users/your-user/.argo-mcp-logs:/app/logs \
  ghcr.io/heapy/argo-workflows-mcp:main

在当地建设

# Build the application first
./gradlew installDist

# Build Docker image
docker build -t argo-workflows-mcp:latest .

# Run with docker-compose
docker-compose up

# Or run directly
docker run -it --rm \
  -e ARGO_BASE_URL=http://your-argo-server:2746 \
  -e ARGO_NAMESPACE=default \
  -e ARGO_TOKEN=your-token \
  -e MCP_AUDIT_FILE=/app/logs/mcp-audit.log \
  -v $(pwd)/logs:/app/logs \
  argo-workflows-mcp:latest

如果为另一台主机颁发了TLS证书（例如 localhost 当您通过访问服务器时 host.docker.internal)，set ARGO_TLS_SERVER_NAME 以使客户端显示正确的SNI值。

环境变量

服务器配置

• MCP_SERVER_NAME -服务器名称（默认值： argo-workflows-mcp)
• MCP_SERVER_VERSION -服务器版本（默认： 0.1.0)

Argo工作流连接

• ARGO_BASE_URL -Argo工作流API URL（默认值： http://localhost:2746)
• ARGO_NAMESPACE -默认Kubernetes命名空间（默认值： default)
• ARGO_TOKEN -用于身份验证的承载令牌
• ARGO_USERNAME -基本身份验证的用户名
• ARGO_PASSWORD -基本身份验证密码
• ARGO_INSECURE_SKIP_TLS_VERIFY -跳过TLS验证（默认值： false)
• ARGO_TLS_SERVER_NAME -建立TLS连接时覆盖TLS服务器名称/SNI值
• ARGO_REQUEST_TIMEOUT_SECONDS -请求超时（默认值： 30)

Kubernetes配置

• KUBECONFIG -kubeconfig文件的路径
• KUBE_CONTEXT -要使用的Kubernetes上下文

权限

• MCP_ALLOW_DESTRUCTIVE -允许删除等破坏性操作（默认值： false)
• MCP_ALLOW_MUTATIONS -允许创建/更新（默认： false)
• MCP_REQUIRE_CONFIRMATION -敏感操作需要确认（默认值： true)
• MCP_NAMESPACES_ALLOW -逗号分隔的允许命名空间列表（默认值： *)
• MCP_NAMESPACES_DENY -以逗号分隔的被拒绝命名空间列表（默认值：空）

日志记录

• MCP_AUDIT_ENABLED -启用审核日志记录（默认值： true)
• MCP_AUDIT_FILE -审核日志文件路径（默认： ./mcp-audit.log)
• MCP_LOG_LEVEL -日志级别：调试、信息、警告、错误（默认值： info)

安全说明

• 默认情况下，服务器以只读模式运行
• 集 MCP_ALLOW_MUTATIONS=true 启用创建/更新操作
• 集 MCP_ALLOW_DESTRUCTIVE=true 启用删除操作
• 使用 MCP_NAMESPACES_ALLOW 限制对特定命名空间的访问
• 所有操作在以下情况下都会被记录 MCP_AUDIT_ENABLED=true

发展

本项目使用：

• Kotlin与协程
• 等级9.2.0
• Java 25
• MCP Kotlin SDK
• 从OpenAPI规范生成Argo工作流客户端

看 代理商.md 发展指南。