MCP Argo Server
About
An MCP server for running Argo workflows, written in Golang
Details
- Author
- jakkaj
- GitHub stars
- 12
- Downloads
- 424
- Categories
- Other
Jump to
- MCP-compliant server for Argo Workflows
- JSON-RPC communication over STDIN/STDOUT
- Launch workflows, check status, retrieve results
- Lightweight CLI tool written in Golang
- Integrates with Kubernetes via client-go
- Includes Python test client for demonstration
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Argo ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Open the project in a dev container or clone and run go mod tidy. Use make cluster to install a k3d cluster and set up Argo. Then run make run to start the MCP server. Alternatively, use the included Python test client by running make install and python test_with_autogen.py in the python/ directory.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp argo server": {
"mcp-argo-server": {
"command": "python",
"args": [
"test_with_autogen.py"
]
}
}
}
}McpServers
{
"mcp-argo-server": {
"command": "python",
"args": [
"test_with_autogen.py"
]
}
}MCP Argo Server
An MCP-compliant server for running Argo Workflows written in Golang.
Overview
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.
Installation
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
Usage
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.
Testing with Python
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:
- Submitting Argo workflows
- Checking workflow status
- Waiting for workflow completion
- Retrieving workflow results
To run the Python test:
1. Ensure you have Python dependencies installed:
cd python
make install
2. Run the test script:
python test_with_autogen.py
or... just debug it to step through.
The script will:
- Connect to the MCP Argo server
- Iterate the tools and print them out
- Submit a sample workflow from kube/argo-hello-world.yaml
- Monitor the workflow status until completion
- Display the workflow results
Contributing
Contributions 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.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Additional Resources
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
