Servidor MCP de Linode

Un servidor MCP (Model Context Protocol) para interactuar con la API de Linode para gestionar recursos en la nube. Este paquete permite a Large Language Models (LLMs) como Claude gestionar instancias Linode a través de una interfaz estandarizada.

Características

• Listar regiones Linode, tipos de instancia e instancias
• Crear, ver detalles, eliminar y reiniciar instancias Linode
• Interfaz segura y fácil de usar para que los LLM gestionen los recursos de Linode
• Totalmente compatible con asistentes de IA habilitados para MCP como Claude

Instalación y Configuración

Establece tu clave API de Linode como variable de entorno:

export LINODE_API_KEY=tu_clave_api_aquí

O utiliza un archivo .env en el directorio del proyecto:

LINODE_API_KEY=tu_clave_api_aquí

Puedes generar una clave API desde el Linode Cloud Manager.

Desde PyPI (Recomendado)

pip install linode-mcp

Usando uv

uvx pip install linode-mcp uvx linode-mcp --api-key $LINODE_API_KEY

Desde el origen

# Clonar el repositorio git clone https://github.com/yourusername/linode-mcp.git cd linode-mcp # Instalar el paquete en modo desarrollo ./scripts/install.sh

Uso

Como herramienta de línea de comandos

# Ejecutar con la configuración por defecto linode-mcp # Activar el registro de depuración linode-mcp --debug # Especificar la clave API en la línea de comandos linode-mcp --api-key your_api_key_here

Con Claude para escritorio

1. Instale el paquete:

   pip install linode-mcp

2. Edite manualmente el archivo de configuración de Claude para Escritorio:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   {"mcpServers": { "linode": {"command": "linode-mcp", "args": ["--api-key", "your_api_key_here"] } }

3. Reiniciar Claude para escritorio

4. En una conversación con Claude, ahora puedes pedirle que

   • Listar tus instancias Linode
   • Crear una nueva instancia Linode
   • Obtener detalles sobre una instancia específica
   • Reiniciar o eliminar instancias

Ejemplo de petición:

• "Mostrar todas mis instancias Linode"
• "Crear un nuevo Linode de 2GB en la región de Frankfurt con Debian 11"
• "Reiniciar mi instancia con ID 12345"

Herramientas disponibles

El paquete proporciona estas herramientas MCP:

• list_regions - Lista todas las regiones Linode disponibles

A añadir:

• list_instance_types - Lista todos los tipos de instancia Linode disponibles y sus precios
• list_instances - Lista todas las instancias Linode existentes
• create_instance - Crear una nueva instancia de Linode
• get_instance - Obtener detalles sobre una instancia de Linode específica
• delete_instance - Elimina una instancia de Linode
• reboot_instance - Reinicia una instancia de Linode

Desarrollo

Estructura del Proyecto

linode-mcp/ ├── bin/ # Scripts de línea de comandos ├── src/ # Código fuente │ └── linode_mcp/ # Paquete principal │ ├── tools/ # Implementaciones de herramientas MCP │ └── server.py # Implementación del servidor MCP ├── setup.py # Archivo de configuración del paquete └── README.md # Este archivo

Cómo contribuir

¡Las contribuciones son bienvenidas! Por favor, siéntase libre de enviar un Pull Request.

1. Fork el repositorio
2. Crea tu rama(git checkout -b feature/amazing-feature)
3. Confirme sus cambios(git commit -m 'Añadir alguna característica asombrosa')
4. Empuja a la rama(git push origin feature/amazing-feature)
5. Abrir una Pull Request

Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

Agradecimientos

• Linode API por proporcionar la API de infraestructura de nube
• Model Context Protocol por la especificación de la interfaz estándar
• Claude por las capacidades del asistente de IA