MCP Argo Server

MCP Argo Server

一个使用 Golang 编写、符合 MCP 规范的 Argo Workflows 运行服务。

概述

MCP Argo Server 是一个轻量级命令行工具，通过 STDIN/STDOUT 上的 JSON-RPC 封装 Argo Workflows。它利用 Foxy Contexts 处理 RPC，并通过 client-go 与 Kubernetes 和 Argo Workflow 资源交互。该项目提供用于启动工作流、检查工作流状态和获取结果的工具。

安装

此项目配置为在开发容器中运行。只需在支持开发容器的编辑器（例如 VS Code Remote - Containers）中打开仓库，即可使用所有预装的依赖项。
如果希望在本地运行，请克隆仓库并运行：

go mod tidy

用法

在开发容器中打开项目。

运行 make cluster，此命令将安装 k3d 集群并设置 Argo。

输入 kubectl cluster-info，即可检查是否成功。

输入 argo submit -n argo --watch ./kube/argo-hello-world.yaml，即可运行测试工作流。

你可以在 https://localhost:2746/workflows/argo/ 查看 Argo 界面。

输入 make run，即可检查应用是否正在构建以及 MCP 是否正常工作。

使用 Python 测试

该项目包含一个 Python 测试客户端，用于演示如何与 MCP Argo 服务交互。测试客户端位于 python/test_with_autogen.py，展示了如何：

• 提交 Argo 工作流
• 检查工作流状态
• 等待工作流完成
• 获取工作流结果

运行 Python 测试：

1. 确保已安装 Python 依赖项：

   cd python
   make install
   

2. 运行测试脚本：

   python test_with_autogen.py
   

或者……直接调试，逐步执行。

脚本将：

• 连接到 MCP Argo 服务
• 遍历工具并将其打印出来
• 提交来自 kube/argo-hello-world.yaml 的示例工作流
• 监控工作流状态直至完成
• 显示工作流结果

贡献

欢迎贡献！请提交问题并发起拉取请求。提交更改前，请确保遵循项目的编码规范并通过所有测试。

许可证

本项目采用 MIT License 许可。详情请参阅 LICENSE 文件。

更多资源

• Argo Workflows
• Foxy Contexts