Talos Linux MCP Server

MCP

by Nosmoht · v2.5.1

MCP server for Talos Linux — resources, services, logs, health, config, lifecycle via gRPC.

mcplocal

MCP configuration

stdio

Command

npx -y talos-mcp@2.5.1

Environment

  • TALOSCONFIG

    Path to talosconfig file (default: ~/.talos/config)

  • TALOS_CONTEXT

    Context name override (default: active context from config)

  • TALOS_ENDPOINTS

    Comma-separated endpoint overrides

  • TALOS_MCP_READ_ONLY

    Set to "true" to disable all mutating tools (default: false)

  • TALOS_MCP_HTTP_ADDR

    If set (e.g. ":8080"), serve Streamable HTTP instead of stdio

  • TALOS_MCP_AUTH_TOKEN

    Required bearer token when HTTP mode is active (TALOS_MCP_HTTP_ADDR is set)

  • TALOS_MCP_ALLOWED_NODES

    Comma-separated IPs, hostnames, and CIDR ranges permitted as tool targets. Unset or empty allows all nodes.

  • TALOS_MCP_ALLOWED_PATHS

    Comma-separated path prefixes permitted for talos_read_file and talos_list_files (e.g. /etc,/proc). Unset or empty allows all paths.

  • TALOS_MCP_SKIP_VERSION_CHECK

    Set to "true" to bypass upgrade path validation (default: false)

  • TALOS_MCP_RATE_LIMIT

    HTTP mode: token-bucket refill rate in requests/second (float, default: 10)

  • TALOS_MCP_RATE_BURST

    HTTP mode: token-bucket burst capacity (int, default: 20)

  • TALOS_MCP_MAX_BODY_SIZE

    HTTP mode: max POST request body size in bytes (int, default: 4194304 = 4 MiB)

  • TALOS_MCP_MAX_CONCURRENT

    HTTP mode: max concurrent POST handlers; returns 503 on overload (int, default: 20)

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.