talos-mcp

talos-mcp

3.4

Talos-MCP is a proof-of-concept implementation of a Model Context Protocol server using the Talos SDK to interact with multiple Talos nodes.

Talos-MCP

:warning: This project is in only a Proof-of-Concept and is not destined to be maintained.

Description

This is a simple implementation of a Talos MCP (Modele Context Protocol) using the Talos SDK to fetch data from multiple Talos nodes.

Features:

  • List disks
  • List network interfaces
  • List CPU and memory usage
  • Reboot nodes

Requirements

  • Golang 1.24 or higher
  • A working Talos cluster

The code is designed to use the endpoint and nodes presents in the talosconfig file. You would need to set these values in the config file.

context: mcp
contexts:
    mcp:
        endpoints: # These values are mandatory
            - 192.168.32.83
        nodes:
            - 192.168.32.83
            - 192.168.32.85
            - 192.168.32.84
        ca: x
        crt: x
        key: x

Installation

  • Clone the repository
git clone https://github.com/qjoly/talos-mcp.git
  • Change directory to the project folder
cd talos-mcp
  • Build the project
go build -o talos-mcp main.go
  • Configure your MCP Client

The following example is for the MCP client mcp-copilot but you can use any MCP client that supports the stdio protocol.

{
    "mcp": {
        "servers": {
            "talos": {
                "type": "stdio",
                "command": "/Users/qjoly/code/mcp-talos/talos-mcp",
                "env": {
                    "TALOSCONFIG": "/Users/qjoly/code/mcp-talos/talosconfig",
                }
            }
        }
    }
}