io.github.Nosmoht

talos-mcp-server

Talos Linux MCP Server

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

stdiocommunityapplication

Package Details

Transportstdio
Runtimenpx

Environment Variables

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)