mcp-omni 0.1.0

MCP server for Omni Talos cluster management

mcp-omni

MCP server for Omni Talos cluster management.

Connects Claude Desktop (or any MCP client) directly to the Omni gRPC API using native PGP signing — no omnictl subprocess required.

Features

• List and inspect clusters, machines, machine sets
• Get cluster status, kubeconfig, talosconfig
• Delete resources
• Apply YAML / sync cluster templates
• Manage service accounts
• Trigger Kubernetes upgrades

Installation

Via Smithery (recommended)

Install directly from Smithery — it handles configuration and registration in your MCP client automatically.

Pre-built binary (macOS / Linux)

brew tap qjoly/tap
brew install qjoly/tap/mcp-omni

Or download the latest binary from the Releases page.

From source

git clone https://github.com/qjoly/mcp-omni
cd mcp-omni
pip install -e .

Configuration

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "omni": {
      "command": "/path/to/mcp-omni",
      "env": {
        "OMNI_ENDPOINT": "https://your-omni.example.com",
        "OMNI_SERVICE_ACCOUNT_KEY": "<base64-service-account-key>"
      }
    }
  }
}

Generate a service account key with:

omnictl serviceaccount create my-mcp-account --role Admin --ttl 8760h

Authentication

The server uses Omni service account keys (base64-encoded JSON with PGP signing) and communicates directly over gRPC — no omnictl binary needed at runtime.