argo-watcher-mcp

shini4i/argo-watcher-mcp

3.2

If you are the rightful owner of argo-watcher-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Argo Watcher MCP Server is a service that integrates Argo Watcher with the Model Context Protocol (MCP) to provide deployment history as a set of tools.

Argo Watcher MCP Server

A simple service that exposes an argo-watcher instance as a set of tools via the Model Context Protocol (MCP), allowing AI agents and other clients to query deployment history.

GitHub Actions GitHub go.mod Go version GitHub release (latest by date) codecov license

[!IMPORTANT] This project is currently a Proof of Concept (PoC). It was built to explore the integration between Argo Watcher and the Model Context Protocol (MCP). As such, it may be subject to significant changes or be abandoned in the future. Please use it with this understanding.

Features

  • Exposes argo-watcher deployment tasks as an MCP tool.
  • Filter deployments by application name and time range.
  • Runs over stdio and HTTP (streamable SSE) via the official MCP Go SDK.
  • Packaged as a production-ready Docker container.
  • Modular, testable Go architecture.

Prerequisites

  • Go 1.25+ (for local builds and development).
  • Docker 24+ (optional, for containerized deployment).
  • Task 3.x (optional, to use the provided Taskfile).
  • A running instance of argo-watcher.

Quickstart

  1. Ensure argo-watcher is running

    The MCP server reads deployment data from an existing argo-watcher instance. You can bootstrap one quickly using the official docker-compose file.

    # In the argo-watcher repository
docker compose up

  2. Configure the MCP server

    Export the required environment variables:

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

  3. Run the server locally

    task run

    The process exposes:

    • Choose the transport via the TRANSPORT_MODE environment variable (stdio or http).
    • In stdio mode the server communicates over stdin/stdout; in http mode it serves a streamable endpoint on HTTP_LISTEN_ADDR (default :8000).

  4. (Optional) Run via 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

Configuration

VariableDefaultDescription
ARGO_WATCHER_URLnone (required)Base URL of the upstream argo-watcher service.
HTTP_LISTEN_ADDR:8000Address for the HTTP/SSE transport.
TRANSPORT_MODEstdioSelects transport: stdio for CLI usage or http for SSE over HTTP.
REQUEST_TIMEOUT15sHTTP timeout for downstream argo-watcher requests.
OTEL_ENABLEDtrueEnables OpenTelemetry instrumentation; set to false to disable all telemetry exports.
OTEL_SERVICE_NAMEinherits APP_NAMEOverrides the OpenTelemetry service.name resource attribute reported by the server.
OTEL_EXPORTER_OTLP_ENDPOINTnoneOptional OTLP gRPC endpoint (host:port) used for exporting metrics and traces.
OTEL_EXPORTER_OTLP_INSECUREfalseSet to true to allow plaintext OTLP connections when the collector does not use TLS.
APP_NAMEargo-watcher-mcpMetadata surfaced via MCP implementation info.
APP_VERSION0.0.1-devVersion surfaced via MCP implementation info.

Telemetry & Metrics

When telemetry is enabled, the HTTP transport exposes Prometheus metrics at /metrics. Key series:

  • argo_watcher_mcp_requests_total{result="success|invalid|failed"} – MCP tool call counter partitioned by result label; filter by result to obtain invalid or failed counts.
  • argo_watcher_reachable – gauge reporting downstream reachability (1 when Argo Watcher responded successfully, 0 otherwise).
  • Standard Go runtime (go_*) and process metrics are registered on the Prometheus endpoint to aid capacity monitoring.

Development

Common tasks are exposed via the included Taskfile:

  • task test – run unit tests.
  • task build – compile the server binary into bin/argo-watcher-mcp.
  • task fmt – format the Go sources.
  • task tidy – tidy module dependencies.
  • task vet – execute go vet ./....
  • task run – start the server locally using the default transport mode (stdio unless TRANSPORT_MODE is set).

Module and build caches live inside .cache/ and are ignored by git.

Releases are produced with GoReleaser and publish multi-architecture container images (linux/amd64 and linux/arm64) to GHCR when tags matching v*.*.* are pushed.

Contributing

As this is a PoC, formal contributions are not the primary focus. However, if you find a bug or have a suggestion, feel free to open an issue.