Linode MCP-Server

Ein MCP-Server (Model Context Protocol), der Ihren KI-Assistenten oder Agenten mit Ihrer Linode-Cloud-Infrastruktur verbindet und es Ihnen ermöglicht, Ihre Cloud-Ressourcen durch natürliche Konversation zu verwalten. Er wurde mit dem FastMCP-Framework erstellt und unterstützt stdio-, SSE- und HTTP-Streaming-Transporte!

Was können Sie damit tun?

Bitten Sie Claude Desktop oder den VSCode Copilot Agent, Ihnen bei Aufgaben zu helfen wie:

• "Zeige mir alle meine Instanzen in der Region Frankfurt"

• "Erstelle eine neue Instanz in Osaka"

• "Erstelle einen Load Balancer für meine Webserver"

• "Richte eine verwaltete MySQL-Datenbank ein" usw.

Dieser Server bietet Tools für die folgenden Linode-Servicekategorien:

• 🖥️ instances - Linode Compute-Instanzen

• 💾 volumes - Block-Storage-Volumes

• 🌐 networking - IP-Adressen, Firewalls, VLANs

• ⚖️ nodebalancers - Load Balancer zur Verkehrsverteilung

• 🌎 regions - Rechenzentrumsstandorte

• 📊 placement - Richtlinien zur Instanzplatzierung

• 🔒 vpcs - Virtual Private Cloud-Netzwerke

• 📦 objectStorage - S3-kompatibler Objektspeicher

• 🔤 domains - DNS-Verwaltung

• 🗄️ databases - Verwaltete MySQL/PostgreSQL-Datenbanken

• ☸️ kubernetes - Kubernetes-Container-Orchestrierung (LKE)

• 💿 images - Benutzerdefinierte Disk-Images für Instanzen

• 📜 stackScripts - Automatisierungsskripte für die Bereitstellung

• 🏷️ tags - Labels zur Ressourcenorganisation

• 🎫 support - Support-Tickets und Anfragen

• 📊 longview - Systemmetriken und Überwachung

• 👤 profile - Benutzerprofil- und Sicherheitseinstellungen

• 🏢 account - Kontoverwaltung, Benutzer und Abrechnung

Erste Schritte

Schnellstart mit npx

Sie benötigen ein Linode-API-Token, um diesen Server zu verwenden. Erstellen Sie eines in Ihren Linode Cloud Manager-Profileinstellungen.

# Start the server with your API token
npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN

Festlegen Ihres API-Tokens

Sie können Ihr Token auf verschiedene Weise bereitstellen:

1. Befehlszeilenoption:

   npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN

2. Umgebungsvariable:

   export LINODE_API_TOKEN=your_token_here
   npx @takashito/linode-mcp-server

3. Umgebungsdatei: Erstellen Sie eine .env-Datei in Ihrem Projektverzeichnis mit:

   LINODE_API_TOKEN=your_token_here

   Führen Sie dann Folgendes aus:

   npx @takashito/linode-mcp-server

Verbindung zu KI-Clients

Claude Desktop

Öffnen Sie die Claude-Einstellungen > Developer > Edit Config:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN"]
    }
  }
}

VSCode/Cursor/Windsurf

Fügen Sie dies zu Ihrer settings.json hinzu:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN", "--categories", "instances,volumes,regions"]
    }
  }
}

⚠️ Hinweis: Verwenden Sie für GPT-4o-basierte Clients --categories, um Tools einzuschränken und Fehler im Kontextfenster zu vermeiden.

Auswahl der Tool-Kategorie

Sie können Tools selektiv mit dem Parameter --categories aktivieren:

# Enable only instances and volumes tools
npx @takashito/linode-mcp-server --token YOUR_TOKEN --categories instances,volumes

Oder in der Claude Desktop-Konfiguration:

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": [
        "-y",
        "@takashito/linode-mcp-server",
        "--token", 
        "YOUR_LINODE_API_TOKEN",
        "--categories",
        "instances,volumes,regions"
      ]
    }
  }
}

Verfügbare Kategorien: instances, volumes, networking, nodebalancers, regions, placement, vpcs, objectStorage, domains, databases, kubernetes, images, stackScripts, tags, support, longview, profile, account

Um alle verfügbaren Kategorien zu sehen:

npx @takashito/linode-mcp-server --list-categories

Transportoptionen

1. stdio-Transport - Standardtransport, kompatibel mit Claude Desktop

   # Default stdio transport
   npx @takashito/linode-mcp-server --token YOUR_TOKEN

2. SSE-Transport - Server-Sent Events-Transport für Web-Clients

   # Start with SSE transport on port 3000 /sse
   npx @takashito/linode-mcp-server --token YOUR_TOKEN --transport sse --port 3000 --endpoint /sse

3. httpStream-Transport - HTTP-Streaming-Transport für Web-Clients

   # Start with HTTP streaming transport on port 8080 /mcp
   npx @takashito/linode-mcp-server --token YOUR_TOKEN --transport http --port 8080 --endpoint /mcp

Sie können Port und Host sowohl für SSE- als auch für HTTP-Streaming-Transporte anpassen:

• --port : Server-Port (Standard: http: 8080, sse: 3000)

• --endpoint : Server-Pfad (Standard: http: /mcp, sse: /sse)

• --host : Server-Host (Standard: 127.0.0.1)

Übergeben des Linode-API-Schlüssels über den Authorization-Header

Für http / sse-Transporte können Sie den MCP-Server ohne den --token-Parameter ausführen.

# Start with HTTP streaming transport on port 8080 /mcp at localhost
npx @takashito/linode-mcp-server --transport http

Konfigurieren Sie Ihren MCP-Client so, dass er einen Authorization-Header hinzufügt. linode-mcp-server leitet dieses API-Token weiter, um auf die Linode-API im Backend zuzugreifen.

{
  "mcpServers": {
    "linode-remote-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8080/mcp",
        "--header",
        "Authorization: Bearer ${LINODE_API_TOKEN}"
      ],
      "env": {
        "LINODE_API_TOKEN": "..."
      }
    },
  }
}

Docker

Führen Sie den MCP-Server als Container mit httpStream-Transport aus.

Build

docker build -t takashito/linode-mcp-server .

Ausführen

# Basic usage (port 8080, all tool categories)
docker run -e LINODE_API_TOKEN=your_token -p 8080:8080 takashito/linode-mcp-server

# Custom port
docker run -e LINODE_API_TOKEN=your_token -e PORT=3000 -p 3000:3000 takashito/linode-mcp-server

# Limit tool categories
docker run -e LINODE_API_TOKEN=your_token -e CATEGORIES=instances,volumes,regions -p 8080:8080 takashito/linode-mcp-server

# Custom endpoint
docker run -e LINODE_API_TOKEN=your_token -e ENDPOINT=/api -p 8080:8080 takashito/linode-mcp-server

Umgebungsvariablen

Verbindung mit MCP-Client

{
  "mcpServers": {
    "linode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8080/mcp",
        "--header",
        "Authorization: Bearer ${LINODE_API_TOKEN}"
      ],
      "env": {
        "LINODE_API_TOKEN": "your_token"
      }
    }
  }
}

Verfügbare Tools

Dieser MCP-Server bietet die folgenden Tools für die Interaktion mit Linode-API-Diensten:

🖥️ Instanzen

Verwalten Sie Linode Compute-Instanzen, einschließlich Erstellung, Löschung und Energieoperationen.

Instanzoperationen

• list_instances - Liste aller Linode-Instanzen abrufen

• get_instance - Details für eine bestimmte Linode-Instanz abrufen

• create_instance - Eine neue Linode-Instanz erstellen

• update_instance - Eine Linode-Instanz aktualisieren

• delete_instance - Eine Linode-Instanz löschen

• reboot_instance - Eine Linode-Instanz neu starten

• boot_instance - Eine Linode-Instanz einschalten

• shutdown_instance - Eine Linode-Instanz ausschalten

• resize_instance - Eine Linode-Instanz in der Größe ändern

• clone_instance - Eine Linode-Instanz auf eine neue Linode klonen

• rebuild_instance - Eine Linode-Instanz mit einem neuen Image neu erstellen

• rescue_instance - Eine Linode-Instanz im Rettungsmodus starten

• reset_root_password - Das Root-Passwort für eine Linode-Instanz zurücksetzen

• initiate_migration - Eine DC-Migration für eine Linode-Instanz einleiten

• upgrade_linode - Eine Linode-Instanz aktualisieren

Instanzkonfiguration

• list_instance_configs - Alle Konfigurationsprofile für eine Linode-Instanz abrufen

• get_instance_config - Ein bestimmtes Konfigurationsprofil für eine Linode-Instanz abrufen

• create_instance_config - Ein neues Konfigurationsprofil für eine Linode-Instanz erstellen

• update_instance_config - Ein Konfigurationsprofil für eine Linode-Instanz aktualisieren

• delete_instance_config - Ein Konfigurationsprofil für eine Linode-Instanz löschen

Schnittstellen für Konfigurationsprofile

• list_config_interfaces - Alle Schnittstellen für ein Konfigurationsprofil auflisten

• get_config_interface - Details für eine bestimmte Schnittstelle eines Konfigurationsprofils abrufen

• create_config_interface - Eine neue Schnittstelle für ein Konfigurationsprofil erstellen

• update_config_interface - Eine Schnittstelle für ein Konfigurationsprofil aktualisieren

• delete_config_interface - Eine Schnittstelle aus einem Konfigurationsprofil löschen

• reorder_config_interfaces - Schnittstellen für ein Konfigurationsprofil neu anordnen

Instanz-Disks

• list_instance_disks - Alle Disks für eine Linode-Instanz abrufen

• get_instance_disk - Eine bestimmte Disk für eine Linode-Instanz abrufen

• create_instance_disk - Eine neue Disk für eine Linode-Instanz erstellen

• update_instance_disk - Eine Disk für eine Linode-Instanz aktualisieren

• delete_instance_disk - Eine Disk für eine Linode-Instanz löschen

• resize_instance_disk - Die Größe einer Disk für eine Linode-Instanz ändern

• clone_disk - Eine Disk auf eine neue Disk klonen

• reset_disk_root_password - Ein Disk-Root-Passwort zurücksetzen

Instanz-Backups

• list_backups - Eine Liste aller Backups für eine Linode-Instanz abrufen

• get_backup - Details für ein bestimmtes Backup abrufen

• create_snapshot - Einen Snapshot für eine Linode-Instanz erstellen

• cancel_backups - Backups für eine Linode-Instanz abbrechen

• enable_backups - Backups für eine Linode-Instanz aktivieren

• restore_backup - Ein Backup auf einer Linode-Instanz wiederherstellen

IP-Verwaltung

• get_networking_information - Netzwerkinformationen für eine Linode-Instanz abrufen

• allocate_ipv4_address - Eine IPv4-Adresse für eine Linode-Instanz zuweisen

• get_ip_address - Details für eine bestimmte IP-Adresse abrufen

• update_ip_address_rdns - Reverse-DNS für eine IP-Adresse aktualisieren

• delete_ipv4_address - Eine IPv4-Adresse löschen

Firewall-Verwaltung

• list_linode_firewalls - Firewalls für eine Linode-Instanz auflisten

• apply_linode_firewalls - Firewalls auf eine Linode-Instanz anwenden

Instanz-Statistiken und Transfer

• get_instance_stats - Aktuelle Statistiken für eine Linode-Instanz abrufen

• get_instance_stats_by_date - Statistiken für eine Linode-Instanz für einen bestimmten Monat abrufen

• get_network_transfer - Netzwerktransferinformationen für eine Linode-Instanz abrufen

• get_monthly_network_transfer - Monatliche Netzwerktransferstatistiken für eine Linode-Instanz abrufen

Zugehörige Ressourcen

• list_instance_nodebalancers - An eine Linode-Instanz angehängte NodeBalancers auflisten

• list_instance_volumes - An eine Linode-Instanz angehängte Volumes auflisten

Kernels und Instanztypen

• list_kernels - Eine Liste aller verfügbaren Kernels abrufen

• get_kernel - Details für einen bestimmten Kernel abrufen

• list_instance_types - Eine Liste aller verfügbaren Linode-Typen abrufen

• get_instance_type - Details für einen bestimmten Linode-Typ abrufen

💾 Volumes

Verwalten Sie Block-Storage-Volumes, die an Linode-Instanzen angehängt werden können.

• list_volumes - Eine Liste aller Volumes abrufen

• get_volume - Details für ein bestimmtes Volume abrufen

• create_volume - Ein neues Volume erstellen

• delete_volume - Ein Volume löschen

• attach_volume - Ein Volume an eine Linode-Instanz anhängen

• detach_volume - Ein Volume von einer Linode-Instanz trennen

• resize_volume - Die Größe eines Volumes ändern

🌐 Networking

Verwalten Sie IP-Adressen, Firewalls und Netzwerkinfrastruktur.

IP-Adressverwaltung

• get_ip_addresses - Alle IP-Adressen abrufen

• get_ip_address - Details für eine bestimmte IP-Adresse abrufen

• update_ip_address - Reverse-DNS für eine IP-Adresse aktualisieren

• allocate_ip - Eine neue IP-Adresse zuweisen

• share_ips - IP-Adressen zwischen Linodes teilen

IPv6-Verwaltung

• get_ipv6_ranges - Alle IPv6-Bereiche abrufen

• get_ipv6_range - Einen bestimmten IPv6-Bereich abrufen

• get_ipv6_pools - Alle IPv6-Pools abrufen

Firewall-Verwaltung

• get_firewalls - Alle Firewalls abrufen

• get_firewall - Details für eine bestimmte Firewall abrufen

• create_firewall - Eine neue Firewall erstellen

• update_firewall - Eine Firewall aktualisieren

• delete_firewall - Eine Firewall löschen

Firewall-Regeln

• get_firewall_rules - Alle Regeln für eine bestimmte Firewall abrufen

• update_firewall_rules - Regeln für eine bestimmte Firewall aktualisieren

Firewall-Geräte

• get_firewall_devices - Alle Geräte für eine bestimmte Firewall abrufen

• create_firewall_device - Ein neues Gerät für eine bestimmte Firewall erstellen

• delete_firewall_device - Ein Gerät von einer bestimmten Firewall löschen

VLAN-Verwaltung

• get_vlans - Alle VLANs abrufen

• get_vlan - Ein bestimmtes VLAN abrufen

🔤 Domains

Verwalten Sie DNS-Domains und Records, die von Linodes DNS-Diensten gehostet werden.

• list_domains - Eine Liste aller Domains abrufen

• get_domain - Details für eine bestimmte Domain abrufen

• create_domain - Eine neue Domain erstellen

• update_domain - Eine bestehende Domain aktualisieren

• delete_domain - Eine Domain löschen

• list_domain_records - Eine Liste aller Domain-Records für eine Domain abrufen

• get_domain_record - Details für einen bestimmten Domain-Record abrufen

• create_domain_record - Einen neuen Domain-Record erstellen

• update_domain_record - Einen Domain-Record aktualisieren

• delete_domain_record - Einen Domain-Record lö