An MCP server for running Argo workflows, written in Golang
An MCP-compliant server for running Argo Workflows written in Golang.
MCP Argo Server is a lightweight CLI tool that wraps Argo Workflows using JSON-RPC over STDIN/STDOUT. It leverages Foxy Contexts for RPC handling and client-go for interacting with Kubernetes and Argo Workflow resources. The project provides tools for launching workflows, checking workflow status, and retrieving results.
This project is configured to run inside a development container. Simply open the repository in your dev container-enabled editor (e.g., VS Code Remote - Containers) and all dependencies are pre-installed.
If you prefer to run it locally, clone the repository and run:
go mod tidy
Open the project in the dev container.
Run make cluster which will install the k3d cluster and set up Argo.
You can check that’s worked by typing kubectl cluster-info.
You can run a test workflow by typing argo submit -n argo --watch ./kube/argo-hello-world.yaml.
You can see the Argo interface at https://localhost:2746/workflows/argo/
You can check that the app is building and the MCP is working by typing make run.
The project includes a Python test client that demonstrates how to interact with the MCP Argo server. The test client is located in python/test_with_autogen.py and showcases:
To run the Python test:
Ensure you have Python dependencies installed:
cd python
make install
Run the test script:
python test_with_autogen.py
or… just debug it to step through.
The script will:
kube/argo-hello-world.yamlContributions are welcome! Please open issues and submit pull requests. Before submitting changes, ensure that you follow the project’s coding guidelines and that all tests pass.
This project is licensed under the MIT License. See the LICENSE{:target=“_blank”} file for details.
