Linode

🚀 Linode MCP Server

A Model Context Protocol (MCP) server for managing cloud resources via Linode's API. This package enables Large Language Models (LLMs) like Claude to manage Linode instances through a standard interface.

🚀 Quick Start

The Linode MCP Server allows you to manage Linode cloud resources through a standard interface, making it convenient for LLMs to operate.

✨ Features

• List Linode regions, instance types, and instances.
• Create, view details, delete, and restart Linode instances.
• Provide a secure and easy - to - use interface for LLMs to manage Linode resources.
• Be fully compatible with MCP - supported AI assistants such as Claude.

📦 Installation

Set up the API key

Set your Linode API key as an environment variable:

export LINODE_API_KEY=your_api_key_here

Or use the .env file in the project directory:

LINODE_API_KEY=your_api_key_here

You can generate an API key in the Linode Cloud Console.

Install from PyPI (Recommended)

pip install linode-mcp

Install using uv

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

Install from source code

# 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 Examples

As a command - line tool

# Run with default settings
linode-mcp

# Enable debug logging
linode-mcp --debug

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

Use with Claude for Desktop

1. Install the package:

pip install linode-mcp

2. Manually edit your Claude Desktop configuration file:
   • 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. Restart Claude for Desktop.
4. In your conversation with Claude, you can now ask it to:
   • List all Linode instances.
   • Create a new Linode instance.
   • Get details of a specific instance.
   • Restart or delete an instance.

Example prompts:

• "Show all my Linode instances."
• "Create a 2GB Linode in the Frankfurt region with Debian 11 installed."
• "Restart the instance with ID 12345."

Available Tools

This package provides the following MCP tools:

• list_regions - List all available Linode regions.

To be added:

• list_instance_types - List all available Linode instance types and their prices.
• list_instances - List all existing Linode instances.
• create_instance - Create a new Linode instance.
• get_instance - Get details of a specific Linode instance.
• delete_instance - Delete a Linode instance.
• reboot_instance - Restart a Linode instance.

🔧 Technical Details

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 installation file
└── README.md             # This file

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

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

📄 License

This project is licensed under the MIT License.