Argo Watcher MCP

Argo观察者MCP服务器

一个简单的服务，它公开了一个 argo监视器 通过模型上下文协议（MCP）将实例作为一组工具，允许AI代理和其他客户端查询部署历史。

\[！重要\] 该项目目前是概念验证（PoC）。它的建立是为了探索Argo Watcher和模型上下文协议（MCP）之间的集成。因此，它可能会发生重大变化或在未来被放弃。请以这种理解来使用它。

特性

• 将argo监视器部署任务作为MCP工具公开。
• 按应用程序名称和时间范围筛选部署。
• 通过官方的MCP Go SDK在stdio和HTTP（流式SSE）上运行。
• 打包为生产就绪的Docker容器。
• 模块化、可测试的Go架构。

先决条件

• 1.25+（用于本地构建和开发）。
• Docker 24+（可选，用于容器化部署）。
• 任务 3.x（可选，使用提供的任务文件）。
• 正在运行的实例 argo监视器.

快速启动

1. 确保argo监视器正在运行

MCP服务器从现有的argo观察程序实例读取部署数据。您可以使用 .

   # In the argo-watcher repository
   docker compose up

1. 配置MCP服务器

导出所需的环境变量：

   export ARGO_WATCHER_URL="http://localhost:8001"  # adjust to your deployment
   export HTTP_LISTEN_ADDR=":8000"

1. 在本地运行服务器

   task run

该过程揭示了：

- 通过以下方式选择运输方式 TRANSPORT_MODE 环境变量(stdio 或 http). - 在 stdio 模式服务器通过stdin/stdout通信；在 http 它为可流式传输的端点提供服务的模式 HTTP_LISTEN_ADDR （默认值 :8000).

1. （可选）通过Docker运行

   GOOS=linux GOARCH=amd64 go build -o argo-watcher-mcp ./cmd/server
   docker build -t argo-watcher-mcp .
   docker run --rm -p 8000:8000 \
     -e ARGO_WATCHER_URL="http://host.docker.internal:8001" \
     argo-watcher-mcp

配置

遥测与度量

启用遥测时，HTTP传输在以下位置公开Prometheus指标 /metrics.钥匙系列：

• argo_watcher_mcp_requests_total{result="success|invalid|failed"} –按结果标签划分的MCP工具调用计数器；筛选依据 result 以获取无效或失败的计数。
• argo_watcher_reachable –仪表报告下游可达性(1 当Argo Watcher成功响应时， 0 否则）。
• 标准Go运行时(go_*)流程指标在Prometheus端点上注册，以帮助进行容量监控。

发展

常见任务通过包含的 Taskfile:

• task test –运行单元测试。
• task build –将服务器二进制文件编译为 bin/argo-watcher-mcp.
• task fmt –格式化Go源代码。
• task tidy –整理模块依赖关系。
• task vet –执行 go vet ./....
• task run –使用默认传输模式在本地启动服务器(stdio 除非 TRANSPORT_MODE 已设置）。

模块和构建缓存位于内部 .cache/ 并且被git忽略。

发布内容由 GoRelease 并发布多架构容器映像(linux/amd64 和 linux/arm64)标签匹配时转换为GHCR v*.*.* 被推。

贡献

由于这是一个PoC，正式的贡献不是主要焦点。但是，如果你发现了一个bug或有建议，请随时提出问题。