linode-mcp

# Linode MCP Server [](https://badge.fury.io/py/linode-mcp) [](https://opensource.org/licenses/MIT) A Model Context Protocol (MCP) server for interacting with Linode's API to manage cloud resources. This package enables Large Language Models (LLMs) like Claude to manage Linode instances through a standardized interface. ## Features - List Linode regions, instance types, and instances - Create, view details, delete, and reboot Linode instances - Secure and easy-to-use interface for LLMs to manage Linode resources - Fully compatible with MCP-enabled AI assistants like Claude ## Installation and Configuration Set your Linode API key as an environment variable: ```bash export LINODE_API_KEY=your_api_key_here ``` Or use a `.env` file in the project directory: ``` LINODE_API_KEY=your_api_key_here ``` You can generate an API key from the [Linode Cloud Manager](https://cloud.linode.com/profile/tokens). ### From PyPI (Recommended) ```bash pip install linode-mcp ``` ### Using uv ```bash uvx pip install linode-mcp uvx linode-mcp --api-key $LINODE_API_KEY ``` ### From Source ```bash # 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 ```bash # 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 1. Install the package: ```bash 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` ```json { "mcpServers": { "linode": { "command": "linode-mcp", "args": ["--api-key", "your_api_key_here"] } } } ``` 3. Restart Claude for Desktop 4. In a conversation with Claude, you can now ask it to: - List your Linode instances - Create a new Linode instance - Get details about a specific instance - Reboot or delete instances 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 The package provides these MCP tools: - `list_regions` - List all available Linode regions To be added: - `list_instance_types` - List all available Linode instance types and their pricing - `list_instances` - List all existing Linode instances - `create_instance` - Create a new Linode instance - `get_instance` - Get details about a specific Linode instance - `delete_instance` - Delete a Linode instance - `reboot_instance` - Reboot a Linode instance ## 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 Contributions are welcome! Please feel free to submit a 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 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ## Acknowledgments - [Linode API](https://www.linode.com/docs/api/) for providing the cloud infrastructure API - [Model Context Protocol](https://modelcontextprotocol.io/) for the standard interface specification - [Claude](https://claude.ai/) for AI assistant capabilities