Talos Linux MCP Server MCP Server

Name: Talos Linux MCP Server MCP Server
Author: io.github.Nosmoht

io.github.Nosmoht/talos-mcp-server

Repository Registry

What is the Talos Linux MCP Server MCP server?

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

How to install Talos Linux MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "talos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ],
      "env": {
        "TALOSCONFIG": "<YOUR_TALOSCONFIG>",
        "TALOS_CONTEXT": "<YOUR_TALOS_CONTEXT>",
        "TALOS_ENDPOINTS": "<YOUR_TALOS_ENDPOINTS>",
        "TALOS_MCP_READ_ONLY": "<YOUR_TALOS_MCP_READ_ONLY>",
        "TALOS_MCP_HTTP_ADDR": "<YOUR_TALOS_MCP_HTTP_ADDR>",
        "TALOS_MCP_AUTH_TOKEN": "<YOUR_TALOS_MCP_AUTH_TOKEN>",
        "TALOS_MCP_ALLOWED_NODES": "<YOUR_TALOS_MCP_ALLOWED_NODES>",
        "TALOS_MCP_ALLOWED_PATHS": "<YOUR_TALOS_MCP_ALLOWED_PATHS>",
        "TALOS_MCP_SKIP_VERSION_CHECK": "<YOUR_TALOS_MCP_SKIP_VERSION_CHECK>",
        "TALOS_MCP_RATE_LIMIT": "<YOUR_TALOS_MCP_RATE_LIMIT>",
        "TALOS_MCP_RATE_BURST": "<YOUR_TALOS_MCP_RATE_BURST>",
        "TALOS_MCP_MAX_BODY_SIZE": "<YOUR_TALOS_MCP_MAX_BODY_SIZE>",
        "TALOS_MCP_MAX_CONCURRENT": "<YOUR_TALOS_MCP_MAX_CONCURRENT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "talos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ],
      "env": {
        "TALOSCONFIG": "<YOUR_TALOSCONFIG>",
        "TALOS_CONTEXT": "<YOUR_TALOS_CONTEXT>",
        "TALOS_ENDPOINTS": "<YOUR_TALOS_ENDPOINTS>",
        "TALOS_MCP_READ_ONLY": "<YOUR_TALOS_MCP_READ_ONLY>",
        "TALOS_MCP_HTTP_ADDR": "<YOUR_TALOS_MCP_HTTP_ADDR>",
        "TALOS_MCP_AUTH_TOKEN": "<YOUR_TALOS_MCP_AUTH_TOKEN>",
        "TALOS_MCP_ALLOWED_NODES": "<YOUR_TALOS_MCP_ALLOWED_NODES>",
        "TALOS_MCP_ALLOWED_PATHS": "<YOUR_TALOS_MCP_ALLOWED_PATHS>",
        "TALOS_MCP_SKIP_VERSION_CHECK": "<YOUR_TALOS_MCP_SKIP_VERSION_CHECK>",
        "TALOS_MCP_RATE_LIMIT": "<YOUR_TALOS_MCP_RATE_LIMIT>",
        "TALOS_MCP_RATE_BURST": "<YOUR_TALOS_MCP_RATE_BURST>",
        "TALOS_MCP_MAX_BODY_SIZE": "<YOUR_TALOS_MCP_MAX_BODY_SIZE>",
        "TALOS_MCP_MAX_CONCURRENT": "<YOUR_TALOS_MCP_MAX_CONCURRENT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "talos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ],
      "env": {
        "TALOSCONFIG": "<YOUR_TALOSCONFIG>",
        "TALOS_CONTEXT": "<YOUR_TALOS_CONTEXT>",
        "TALOS_ENDPOINTS": "<YOUR_TALOS_ENDPOINTS>",
        "TALOS_MCP_READ_ONLY": "<YOUR_TALOS_MCP_READ_ONLY>",
        "TALOS_MCP_HTTP_ADDR": "<YOUR_TALOS_MCP_HTTP_ADDR>",
        "TALOS_MCP_AUTH_TOKEN": "<YOUR_TALOS_MCP_AUTH_TOKEN>",
        "TALOS_MCP_ALLOWED_NODES": "<YOUR_TALOS_MCP_ALLOWED_NODES>",
        "TALOS_MCP_ALLOWED_PATHS": "<YOUR_TALOS_MCP_ALLOWED_PATHS>",
        "TALOS_MCP_SKIP_VERSION_CHECK": "<YOUR_TALOS_MCP_SKIP_VERSION_CHECK>",
        "TALOS_MCP_RATE_LIMIT": "<YOUR_TALOS_MCP_RATE_LIMIT>",
        "TALOS_MCP_RATE_BURST": "<YOUR_TALOS_MCP_RATE_BURST>",
        "TALOS_MCP_MAX_BODY_SIZE": "<YOUR_TALOS_MCP_MAX_BODY_SIZE>",
        "TALOS_MCP_MAX_CONCURRENT": "<YOUR_TALOS_MCP_MAX_CONCURRENT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "talos-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "talos-mcp"
      ],
      "env": {
        "TALOSCONFIG": "<YOUR_TALOSCONFIG>",
        "TALOS_CONTEXT": "<YOUR_TALOS_CONTEXT>",
        "TALOS_ENDPOINTS": "<YOUR_TALOS_ENDPOINTS>",
        "TALOS_MCP_READ_ONLY": "<YOUR_TALOS_MCP_READ_ONLY>",
        "TALOS_MCP_HTTP_ADDR": "<YOUR_TALOS_MCP_HTTP_ADDR>",
        "TALOS_MCP_AUTH_TOKEN": "<YOUR_TALOS_MCP_AUTH_TOKEN>",
        "TALOS_MCP_ALLOWED_NODES": "<YOUR_TALOS_MCP_ALLOWED_NODES>",
        "TALOS_MCP_ALLOWED_PATHS": "<YOUR_TALOS_MCP_ALLOWED_PATHS>",
        "TALOS_MCP_SKIP_VERSION_CHECK": "<YOUR_TALOS_MCP_SKIP_VERSION_CHECK>",
        "TALOS_MCP_RATE_LIMIT": "<YOUR_TALOS_MCP_RATE_LIMIT>",
        "TALOS_MCP_RATE_BURST": "<YOUR_TALOS_MCP_RATE_BURST>",
        "TALOS_MCP_MAX_BODY_SIZE": "<YOUR_TALOS_MCP_MAX_BODY_SIZE>",
        "TALOS_MCP_MAX_CONCURRENT": "<YOUR_TALOS_MCP_MAX_CONCURRENT>"
      }
    }
  }
}

Claude Code

claude mcp add talos-mcp-server --env TALOSCONFIG=<YOUR_TALOSCONFIG> --env TALOS_CONTEXT=<YOUR_TALOS_CONTEXT> --env TALOS_ENDPOINTS=<YOUR_TALOS_ENDPOINTS> --env TALOS_MCP_READ_ONLY=<YOUR_TALOS_MCP_READ_ONLY> --env TALOS_MCP_HTTP_ADDR=<YOUR_TALOS_MCP_HTTP_ADDR> --env TALOS_MCP_AUTH_TOKEN=<YOUR_TALOS_MCP_AUTH_TOKEN> --env TALOS_MCP_ALLOWED_NODES=<YOUR_TALOS_MCP_ALLOWED_NODES> --env TALOS_MCP_ALLOWED_PATHS=<YOUR_TALOS_MCP_ALLOWED_PATHS> --env TALOS_MCP_SKIP_VERSION_CHECK=<YOUR_TALOS_MCP_SKIP_VERSION_CHECK> --env TALOS_MCP_RATE_LIMIT=<YOUR_TALOS_MCP_RATE_LIMIT> --env TALOS_MCP_RATE_BURST=<YOUR_TALOS_MCP_RATE_BURST> --env TALOS_MCP_MAX_BODY_SIZE=<YOUR_TALOS_MCP_MAX_BODY_SIZE> --env TALOS_MCP_MAX_CONCURRENT=<YOUR_TALOS_MCP_MAX_CONCURRENT> -- npx -y talos-mcp