Talos Linux MCP Server

by nosmohtio.github.Nosmoht/talos-mcp-serverv2.5.1

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

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained50d ago

Install Talos Linux MCP server

claude mcp add talos -- npx -y talos-mcp

{
  "mcpServers": {
    "talos": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "talos": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "talos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "talos": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Variable	Required	Secret	Description
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)