← Index

Talos Linux MCP Server

io.github.Nosmoht/talos-mcp-server·v2.3.3·Monitoring & Logs
Quality Score
90
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "talos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ],
      "env": {
        "TALOSCONFIG": "<talosconfig>",
        "TALOS_CONTEXT": "<talos_context>",
        "TALOS_ENDPOINTS": "<talos_endpoints>",
        "TALOS_MCP_READ_ONLY": "<talos_mcp_read_only>",
        "TALOS_MCP_HTTP_ADDR": "<talos_mcp_http_addr>",
        "TALOS_MCP_AUTH_TOKEN": "<talos_mcp_auth_token>",
        "TALOS_MCP_ALLOWED_NODES": "<talos_mcp_allowed_nodes>",
        "TALOS_MCP_ALLOWED_PATHS": "<talos_mcp_allowed_paths>",
        "TALOS_MCP_SKIP_VERSION_CHECK": "<talos_mcp_skip_version_check>",
        "TALOS_MCP_RATE_LIMIT": "<talos_mcp_rate_limit>",
        "TALOS_MCP_RATE_BURST": "<talos_mcp_rate_burst>",
        "TALOS_MCP_MAX_BODY_SIZE": "<talos_mcp_max_body_size>",
        "TALOS_MCP_MAX_CONCURRENT": "<talos_mcp_max_concurrent>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "talos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ],
      "env": {
        "TALOSCONFIG": "<talosconfig>",
        "TALOS_CONTEXT": "<talos_context>",
        "TALOS_ENDPOINTS": "<talos_endpoints>",
        "TALOS_MCP_READ_ONLY": "<talos_mcp_read_only>",
        "TALOS_MCP_HTTP_ADDR": "<talos_mcp_http_addr>",
        "TALOS_MCP_AUTH_TOKEN": "<talos_mcp_auth_token>",
        "TALOS_MCP_ALLOWED_NODES": "<talos_mcp_allowed_nodes>",
        "TALOS_MCP_ALLOWED_PATHS": "<talos_mcp_allowed_paths>",
        "TALOS_MCP_SKIP_VERSION_CHECK": "<talos_mcp_skip_version_check>",
        "TALOS_MCP_RATE_LIMIT": "<talos_mcp_rate_limit>",
        "TALOS_MCP_RATE_BURST": "<talos_mcp_rate_burst>",
        "TALOS_MCP_MAX_BODY_SIZE": "<talos_mcp_max_body_size>",
        "TALOS_MCP_MAX_CONCURRENT": "<talos_mcp_max_concurrent>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y talos-mcp
§02  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)

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
15
installability
25
documentation
15
stability
10
§04  Alternatives in Monitoring & Logs