MCP Argo Server

🚀 MCP Argo 服務器

MCP Argo 服務器是一款符合 MCP 標準的輕量級 CLI 工具，採用 Golang 編寫，用於運行 Argo Workflows。它藉助 JSON - RPC 協議在 STDIN 和 STDOUT 上實現通信。

🚀 快速開始

MCP Argo 服務器利用 Foxy Contexts 處理 RPC 請求，同時藉助 client - go 與 Kubernetes 和 Argo 工作流資源進行交互。該項目提供了啟動工作流、檢查工作流狀態以及獲取結果的工具。

📦 安裝指南

此項目配置為在開發容器中運行。您只需在支持遠程容器的代碼編輯器（例如 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 測試客戶端，用於演示如何與 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 文件。

📚 詳細文檔

額外資源

• Argo 工作流
• Foxy Contexts