MCP Server
MCP
Talos Linux MCP Server
By MCP server for Talos Linux — resources, services, logs, health, config, lifecycle via gRPC.
Install
npx -y [email protected]Configuration Example
{
"remotes": [],
"packages": [
{
"registryType": "npm",
"identifier": "talos-mcp",
"version": "2.5.1",
"runtimeHint": "npx",
"transport": {
"type": "stdio"
},
"environmentVariables": [
{
"description": "Path to talosconfig file (default: ~/.talos/config)",
"name": "TALOSCONFIG"
},
{
"description": "Context name override (default: active context from config)",
"name": "TALOS_CONTEXT"
},
{
"description": "Comma-separated endpoint overrides",
"name": "TALOS_ENDPOINTS"
},
{
"description": "Set to \"true\" to disable all mutating tools (default: false)",
"name": "TALOS_MCP_READ_ONLY"
},
{
"description": "If set (e.g. \":8080\"), serve Streamable HTTP instead of stdio",
"name": "TALOS_MCP_HTTP_ADDR"
},
{
"description": "Required bearer token when HTTP mode is active (TALOS_MCP_HTTP_ADDR is set)",
"name": "TALOS_MCP_AUTH_TOKEN"
},
{
"description": "Comma-separated IPs, hostnames, and CIDR ranges permitted as tool targets. Unset or empty allows all nodes.",
"name": "TALOS_MCP_ALLOWED_NODES"
},
{
"description": "Comma-separated path prefixes permitted for talos_read_file and talos_list_files (e.g. /etc,/proc). Unset or empty allows all paths.",
"name": "TALOS_MCP_ALLOWED_PATHS"
},
{
"description": "Set to \"true\" to bypass upgrade path validation (default: false)",
"name": "TALOS_MCP_SKIP_VERSION_CHECK"
},
{
"description": "HTTP mode: token-bucket refill rate in requests/second (float, default: 10)",
"name": "TALOS_MCP_RATE_LIMIT"
},
{
"description": "HTTP mode: token-bucket burst capacity (int, default: 20)",
"name": "TALOS_MCP_RATE_BURST"
},
{
"description": "HTTP mode: max POST request body size in bytes (int, default: 4194304 = 4 MiB)",
"name": "TALOS_MCP_MAX_BODY_SIZE"
},
{
"description": "HTTP mode: max concurrent POST handlers; returns 503 on overload (int, default: 20)",
"name": "TALOS_MCP_MAX_CONCURRENT"
}
]
}
]
}
mcp
model-context-protocol
npm
Comments
Sign in to leave a comment