Servidor MCP de Linode

Un servidor MCP (Model Context Protocol) que conecta tu asistente de IA o agente a tu infraestructura en la nube de Linode, permitiéndote gestionar tus recursos en la nube a través de una conversación natural. Construido con el framework FastMCP y compatible con transportes de streaming stdio, SSE y HTTP.

¿Qué puedes hacer con esto?

Pide a Claude Desktop o al agente de VSCode Copilot que te ayude con tareas como:

• "Muéstrame todas mis instancias en la región de Frankfurt"

• "Crea una nueva instancia en Osaka"

• "Crea un balanceador de carga para mis servidores web"

• "Configura una base de datos MySQL gestionada" etc.

Este servidor proporciona herramientas para las siguientes categorías de servicios de Linode:

• 🖥️ instances - Instancias de computación Linode

• 💾 volumes - Volúmenes de almacenamiento en bloque

• 🌐 networking - Direcciones IP, firewalls, VLANs

• ⚖️ nodebalancers - Balanceadores de carga para distribuir tráfico

• 🌎 regions - Ubicaciones de centros de datos

• 📊 placement - Políticas de ubicación de instancias

• 🔒 vpcs - Redes de nube privada virtual (VPC)

• 📦 objectStorage - Almacenamiento de objetos compatible con S3

• 🔤 domains - Gestión de DNS

• 🗄️ databases - Bases de datos MySQL/PostgreSQL gestionadas

• ☸️ kubernetes - Orquestación de contenedores Kubernetes (LKE)

• 💿 images - Imágenes de disco personalizadas para instancias

• 📜 stackScripts - Scripts de automatización de despliegue

• 🏷️ tags - Etiquetas de organización de recursos

• 🎫 support - Tickets y solicitudes de soporte

• 📊 longview - Métricas y monitorización del sistema

• 👤 profile - Perfil de usuario y ajustes de seguridad

• 🏢 account - Gestión de cuentas, usuarios y facturación

Primeros pasos

Inicio rápido con npx

Necesitarás un token de API de Linode para usar este servidor. Crea uno en los ajustes de perfil de Linode Cloud Manager.

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

Configuración de tu token de API

Puedes proporcionar tu token de varias maneras:

1. Opción de línea de comandos:

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

2. Variable de entorno:

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

3. Archivo de entorno: Crea un archivo .env en el directorio de tu proyecto con:

LINODE_API_TOKEN=your_token_here

Luego ejecuta:

npx @takashito/linode-mcp-server

Conexión a clientes de IA

Claude Desktop

Abre los ajustes de Claude > Developer > Edit Config:

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

VSCode/Cursor/Windsurf

Añade a tu settings.json:

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

⚠️ Nota: Para clientes basados en GPT-4o, usa --categories para limitar las herramientas y evitar errores de ventana de contexto.

Selección de categoría de herramientas

Puedes habilitar herramientas de forma selectiva con el parámetro --categories:

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

O en la configuración de Claude Desktop:

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

Categorías disponibles: instances, volumes, networking, nodebalancers, regions, placement, vpcs, objectStorage, domains, databases, kubernetes, images, stackScripts, tags, support, longview, profile, account

Para ver todas las categorías disponibles:

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

Opciones de transporte

1. Transporte stdio - Transporte predeterminado compatible con Claude Desktop

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

2. Transporte SSE - Transporte de eventos enviados por el servidor (Server-Sent Events) para clientes web

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

3. Transporte httpStream - Transporte de streaming HTTP para clientes web

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

Puedes personalizar el puerto y el host tanto para el transporte SSE como para el de streaming HTTP:

• --port : Puerto del servidor (predeterminado: http: 8080, sse: 3000)

• --endpoint : Ruta del servidor (predeterminado: http: /mcp, sse: /sse)

• --host : Host del servidor (predeterminado: 127.0.0.1)

Pasar la clave de API de Linode mediante el encabezado de autorización

Para el transporte http / sse, puedes ejecutar el servidor mcp sin el parámetro --token.

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

Configura tu cliente mcp para añadir el encabezado de autorización (Authorization Header). linode-mcp-server reenvía este token de API para acceder a la API de Linode en el backend.

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

Docker

Ejecuta el servidor MCP como un contenedor con transporte httpStream.

Construcción

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

Ejecución

# 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

Variables de entorno

Conexión con cliente MCP

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

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas para interactuar con los servicios de la API de Linode:

🖥️ Instancias

Gestiona instancias de computación Linode, incluyendo creación, eliminación y operaciones de energía.

Operaciones de instancia

• list_instances - Obtener una lista de todas las instancias Linode

• get_instance - Obtener detalles de una instancia Linode específica

• create_instance - Crear una nueva instancia Linode

• update_instance - Actualizar una instancia Linode

• delete_instance - Eliminar una instancia Linode

• reboot_instance - Reiniciar una instancia Linode

• boot_instance - Encender una instancia Linode

• shutdown_instance - Apagar una instancia Linode

• resize_instance - Cambiar el tamaño de una instancia Linode

• clone_instance - Clonar una instancia Linode en una nueva

• rebuild_instance - Reconstruir una instancia Linode con una nueva imagen

• rescue_instance - Arrancar una instancia Linode en modo rescate

• reset_root_password - Restablecer la contraseña de root de una instancia Linode

• initiate_migration - Iniciar una migración de centro de datos para una instancia Linode

• upgrade_linode - Actualizar una instancia Linode

Configuración de instancia

• list_instance_configs - Obtener todos los perfiles de configuración de una instancia Linode

• get_instance_config - Obtener un perfil de configuración específico de una instancia Linode

• create_instance_config - Crear un nuevo perfil de configuración para una instancia Linode

• update_instance_config - Actualizar un perfil de configuración de una instancia Linode

• delete_instance_config - Eliminar un perfil de configuración de una instancia Linode

Interfaces de perfil de configuración

• list_config_interfaces - Listar todas las interfaces de un perfil de configuración

• get_config_interface - Obtener detalles de una interfaz de perfil de configuración específica

• create_config_interface - Crear una nueva interfaz para un perfil de configuración

• update_config_interface - Actualizar una interfaz de un perfil de configuración

• delete_config_interface - Eliminar una interfaz de un perfil de configuración

• reorder_config_interfaces - Reordenar interfaces de un perfil de configuración

Discos de instancia

• list_instance_disks - Obtener todos los discos de una instancia Linode

• get_instance_disk - Obtener un disco específico de una instancia Linode

• create_instance_disk - Crear un nuevo disco para una instancia Linode

• update_instance_disk - Actualizar un disco de una instancia Linode

• delete_instance_disk - Eliminar un disco de una instancia Linode

• resize_instance_disk - Cambiar el tamaño de un disco de una instancia Linode

• clone_disk - Clonar un disco en uno nuevo

• reset_disk_root_password - Restablecer la contraseña de root de un disco

Copias de seguridad de instancia

• list_backups - Obtener una lista de todas las copias de seguridad de una instancia Linode

• get_backup - Obtener detalles de una copia de seguridad específica

• create_snapshot - Crear una instantánea de una instancia Linode

• cancel_backups - Cancelar copias de seguridad de una instancia Linode

• enable_backups - Habilitar copias de seguridad para una instancia Linode

• restore_backup - Restaurar una copia de seguridad en una instancia Linode

Gestión de IP

• get_networking_information - Obtener información de red de una instancia Linode

• allocate_ipv4_address - Asignar una dirección IPv4 a una instancia Linode

• get_ip_address - Obtener detalles de una dirección IP específica

• update_ip_address_rdns - Actualizar el DNS inverso de una dirección IP

• delete_ipv4_address - Eliminar una dirección IPv4

Gestión de Firewall

• list_linode_firewalls - Listar firewalls de una instancia Linode

• apply_linode_firewalls - Aplicar firewalls a una instancia Linode

Estadísticas y transferencia de instancia

• get_instance_stats - Obtener estadísticas actuales de una instancia Linode

• get_instance_stats_by_date - Obtener estadísticas de una instancia Linode para un mes específico

• get_network_transfer - Obtener información de transferencia de red de una instancia Linode

• get_monthly_network_transfer - Obtener estadísticas de transferencia de red mensual de una instancia Linode

Recursos relacionados

• list_instance_nodebalancers - Listar NodeBalancers adjuntos a una instancia Linode

• list_instance_volumes - Listar volúmenes adjuntos a una instancia Linode

Kernels y tipos de instancia

• list_kernels - Obtener una lista de todos los kernels disponibles

• get_kernel - Obtener detalles de un kernel específico

• list_instance_types - Obtener una lista de todos los tipos de Linode disponibles

• get_instance_type - Obtener detalles de un tipo de Linode específico

💾 Volúmenes

Gestiona volúmenes de almacenamiento en bloque que pueden adjuntarse a instancias Linode.

• list_volumes - Obtener una lista de todos los volúmenes

• get_volume - Obtener detalles de un volumen específico

• create_volume - Crear un nuevo volumen

• delete_volume - Eliminar un volumen

• attach_volume - Adjuntar un volumen a una instancia Linode

• detach_volume - Desadjuntar un volumen de una instancia Linode

• resize_volume - Cambiar el tamaño de un volumen

🌐 Redes

Gestiona direcciones IP, firewalls e infraestructura de red.

Gestión de direcciones IP

• get_ip_addresses - Obtener todas las direcciones IP

• get_ip_address - Obtener detalles de una dirección IP específica

• update_ip_address - Actualizar el DNS inverso de una dirección IP

• allocate_ip - Asignar una nueva dirección IP

• share_ips - Compartir direcciones IP entre Linodes

Gestión de IPv6

• get_ipv6_ranges - Obtener todos los rangos IPv6

• get_ipv6_range - Obtener un rango IPv6 específico

• get_ipv6_pools - Obtener todos los pools IPv6

Gestión de Firewall

• get_firewalls - Obtener todos los firewalls

• get_firewall - Obtener detalles de un firewall específico

• create_firewall - Crear un nuevo firewall

• update_firewall - Actualizar un firewall

• delete_firewall - Eliminar un firewall

Reglas de Firewall

• get_firewall_rules - Obtener todas las reglas de un firewall específico

• update_firewall_rules - Actualizar las reglas de un firewall específico

Dispositivos de Firewall

• get_firewall_devices - Obtener todos los dispositivos de un firewall específico

• create_firewall_device - Crear un nuevo dispositivo para un firewall específico

• delete_firewall_device - Eliminar un dispositivo de un firewall específico

Gestión de VLAN

• get_vlans - Obtener todas las VLANs

• get_vlan - Obtener una VLAN específica

🔤 Dominios

Gestiona dominios DNS y registros alojados por los servicios DNS de Linode.

• list_domains - Obtener una lista de todos los dominios

• get_domain - Obtener detalles de un dominio específico

• create_domain - Crear un nuevo dominio

• update_domain - Actualizar un dominio existente

• delete_domain - Eliminar un dominio

• list_domain_records - Obtener una lista de todos los registros de dominio de un dominio

• get_domain_record - Obtener detalles de un registro de dominio específico

• create_domain_record - Crear un nuevo registro de dominio

• update_domain_record - Actualizar un registro de dominio

• delete_domain_record - Eliminar un registro de dominio

• import_domain_zone - Importar una zona de dominio desde un servidor de nombres remoto

• clone_domain - Clonar un dominio existente en uno nuevo

• get_zone_file - Obtener el archivo de zona DNS de un dominio

🗄️ Bases de datos

Gestiona los servicios de base de datos gestionada de Linode para MySQL y PostgreSQL.

Operaciones generales de base de datos

• list_database_engines - Obtener una lista de todos los motores de base de datos disponibles (versiones de MySQL, PostgreSQL)

• get_database_engine - Obtener detalles de una versión de motor de base de datos específica

• list_database_types - Obtener una lista de todos los tipos de instancia de base de