Linode MCP Server

Un servidor Model Context Protocol (MCP) per interactuar amb l'API de Linode i gestionar recursos en la núvol. Aquest paquet permet que models de llenguatge gran (LLMs) com Claude gestionin instàncies de Linode mitjançant una interfície estàndard.

Features

• Llistar regions, tipus d'instàncies i instàncies de Linode
• Crear, veure detalls, eliminar i reiniciar instàncies de Linode
• Interfície segura i fàcil d'usar per als LLMs per gestionar recursos de Linode
• Totalment compatible amb assistents d'IA habilitats amb MCP com Claude

Installation and Configuration

Estableix la teva clau API de Linode com a variable d'entorn:

export LINODE_API_KEY=your_api_key_here

O utilitza un fitxer .env al directori del projecte:

LINODE_API_KEY=your_api_key_here

Pots generar una clau API des del Linode Cloud Manager.

From PyPI (Recommended)

pip install linode-mcp

Using uv

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

From Source

# Clone the repository
git clone https://github.com/yourusername/linode-mcp.git
cd linode-mcp

# Install the package in development mode
./scripts/install.sh

Usage

As a Command Line Tool

# Run with default settings
linode-mcp

# Enable debug logging
linode-mcp --debug

# Specify API key on command line
linode-mcp --api-key your_api_key_here

With Claude for Desktop

Instal·la el paquet:

pip install linode-mcp

Edita manualment el fitxer de configuració de Claude Desktop:

• 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"]
    }
  }
}

Reinicia Claude per a Desktop.

En una conversa amb Claude, ara pots demanar-li que:

• Llistar totes les teves instàncies de Linode
• Crear una nova instància de Linode
• Obtenir detalls d'una instància específica
• Reiniciar o eliminar instàncies

Example prompts:

• "Show me all my Linode instances"
• "Create a new 2GB Linode in the Frankfurt region with Debian 11"
• "Reboot my instance with ID 12345"

Available Tools

El paquet proporciona aquestes eines MCP:

• list_regions - Llistar totes les regions disponibles de Linode

To be added:

• list_instance_types - Llistar tots els tipus d'instàncies disponibles de Linode i els seus preus
• list_instances - Llistar totes les instàncies existents de Linode
• create_instance - Crear una nova instància de Linode
• get_instance - Obtenir detalls d'una instància de Linode específica
• delete_instance - Eliminar una instància de Linode
• reboot_instance - Reiniciar una instància de Linode

Development

Project Structure

linode-mcp/
├── bin/                  # Command-line scripts
├── src/                  # Source code
│   └── linode_mcp/       # Main package
│       ├── tools/        # MCP tool implementations
│       └── server.py     # MCP server implementation
├── setup.py              # Package setup file
└── README.md             # This file

Contributing

Les contribucions són benvingudes! Si us plau, envia una Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

Este projecte està llicenciat sota la llicència MIT - vegeu el fitxer LICENSE per a més detalls.

Acknowledgments

• Linode API per proporcionar l'API d'infraestructura en núvol
• Model Context Protocol per la especificació de la interfície estàndard
• Claude per les capacitats d'assistent d'IA