MCP Vultr

🚀 Vultr MCP

The Ultimate Model Context Protocol Server for Vultr Cloud Management

Transform your cloud infrastructure with natural language commands

This project offers a comprehensive solution for managing Vultr cloud services. It provides over 335 management tools across 27 service modules, enabling users to interact with their Vultr infrastructure using natural language through compatible AI assistants.

🚀 Quick Start • 📖 Documentation • 🛠️ Features • 💡 Examples • 🤝 Contributing

🚀 Quick Start

📦 Installation

# 🏃‍♂️ Fast installation with uv (recommended)
uv add mcp-vultr

# 📦 Traditional pip installation  
pip install mcp-vultr

⚙️ Setup with Claude Code

# 🔑 Set your Vultr API key
export VULTR_API_KEY="your-vultr-api-key"

# 🔌 Add to Claude Code (one command!)
claude mcp add vultr vultr-mcp-server --env VULTR_API_KEY="${VULTR_API_KEY}"

🎉 Start Managing!

# 🚀 Launch the MCP server
vultr-mcp-server

That's it! You now have 335+ Vultr management tools available through natural language in Claude Code.

✨ Features

🌟 Core Capabilities

🎯 Enterprise Features (v2.1.0)

🏗️ Service Coverage (335+ Tools)

💻 Usage Examples

Basic Usage

import asyncio
from mcp_vultr import VultrDNSClient, VultrDNSServer

async def deploy_website():
    """🚀 Deploy a complete website infrastructure"""
    
    # High-level DNS client
    dns = VultrDNSClient("your-api-key")
    
    # Full API client with smart identifiers
    vultr = VultrDNSServer("your-api-key")
    
    # 🌐 Create domain and DNS records
    await dns.create_domain("mysite.com", "192.168.1.100") 
    await dns.add_a_record("mysite.com", "www", "192.168.1.100")
    await dns.add_mx_record("mysite.com", "@", "mail.mysite.com", 10)
    
    # 🖥️ Deploy instance with smart naming
    instance = await vultr.create_instance(
        region="ewr",
        plan="vc2-1c-1gb", 
        os_id=387,
        label="web-server",  # 🏷️ Human-readable name!
        hostname="web.mysite.com"
    )
    
    # 🔥 Configure firewall by description
    firewall = await vultr.get_firewall_group("web-servers")
    
    # 📊 Get real-time metrics
    stats = await vultr.get_instance_bandwidth("web-server")  # By name!
    
    print(f"✅ Deployed {instance['label']} with {stats['incoming']}GB traffic")

asyncio.run(deploy_website())

Advanced Usage

# 🌈 Stunning domain overview with colors and status indicators
$ mcp-vultr domains list

                    Vultr DNS Domains (49 found)                     
┏━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
┃ Domain                  ┃ Created                   ┃ DNSSEC      ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
│ api.mycompany.com       │ 2024-01-15T10:30:00+00:00 │ ✅ enabled  │
│ webapp.io               │ 2024-03-22T14:20:00+00:00 │ ❌ disabled │
│ blog.example.com        │ 2024-07-10T09:15:00+00:00 │ ✅ enabled  │
└─────────────────────────┴───────────────────────────┴─────────────┘

# 🚀 Professional server startup with branded panels
$ mcp-vultr server
╭────────────────────────────── Vultr MCP Server ──────────────────────────────╮
│ 🚀 Starting Vultr DNS MCP Server                                             │
│ 🔑 API Key: your-key-abc123...                                               │
│ 🔄 Press Ctrl+C to stop                                                      │
╰──────────────────────────────────────────────────────────────────────────────╯

# 🏗️ Infrastructure management with smart names  
mcp-vultr instances create --label "api-server" --region ewr --plan vc2-2c-4gb
mcp-vultr instances start api-server                    # Start by name!
mcp-vultr instances attach-volume api-server db-storage # Attach by names!

# 🌐 DNS management with real-time feedback
mcp-vultr domains create api.mycompany.com 192.168.1.200
mcp-vultr records add api.mycompany.com A @ 192.168.1.200
mcp-vultr setup-website api.mycompany.com 192.168.1.200 --ssl

# 🐳 Kubernetes cluster management  
mcp-vultr k8s create production-cluster --region ewr --nodes 3
mcp-vultr k8s scale production-cluster --nodes 5       # Scale by name!
mcp-vultr k8s get-costs production-cluster             # Cost analysis!

🎯 Smart Identifier Resolution

Stop wrestling with UUIDs! Vultr MCP's killer feature is smart identifier resolution - use human-readable names instead of cryptic UUIDs across all services.

🏷️ Before vs After

# 😤 The old way (UUIDs everywhere)
vultr instance stop cb676a46-66fd-4dfb-b839-443f2e6c0b60
vultr firewall rule add 5f2a4b6c-7b8d-4e9f-a1b2-3c4d5e6f7a8b --port 443

# 🎉 The Vultr MCP way (human names!)
mcp-vultr instances stop web-server  
mcp-vultr firewall rules add web-servers --port 443

🧠 Smart Resolution Across All Services

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        🤖 AI Assistant                          │
│                     (Claude Code/Desktop)                       │
└──────────────────────────┬──────────────────────────────────────┘
                           │ Natural Language Commands
┌──────────────────────────▼──────────────────────────────────────┐
│                   📡 Vultr MCP Server                           │
│                      (335+ Tools)                               │
├─────────────────────────────────────────────────────────────────┤
│  🌐 DNS  🖥️ Compute  🐳 K8s  🗄️ DB  🔥 Security  💾 Storage    │
│  📊 Analytics  🌍 CDN  ⚖️ LB  🚀 Serverless  👥 Users          │
└──────────────────────────┬──────────────────────────────────────┘
                           │ Smart API Calls
┌──────────────────────────▼──────────────────────────────────────┐
│                      ☁️ Vultr Cloud API                         │
│              (Complete Infrastructure Management)                │
└─────────────────────────────────────────────────────────────────┘

📚 Documentation

🚀 Getting Started

• ⚡ Quick Start Guide
• 🔧 Installation & Setup
• 🎯 First Steps with Claude Code

📚 API Reference

• 🐍 Python API Documentation
• 🖥️ CLI Command Reference
• 🤖 MCP Tools Reference

🎓 Tutorials & Examples

• 🏗️ Infrastructure as Code with Natural Language
• 🌐 Complete Website Deployment
• ☸️ Kubernetes Cluster Management

🛠️ Development

🏃‍♂️ Quick Setup

# 📥 Clone the repository
git clone https://git.supported.systems/MCP/mcp-vultr.git
cd mcp-vultr

# ⚡ Install with uv (recommended)
uv sync --extra dev

# 🧪 Run tests (multiple performance modes)
make test-fast          # ⚡ Quick tests (30-60s)
make test-parallel      # 🚀 Parallel execution (60-120s) 
make test-coverage      # 📊 Full coverage (180-300s)

# 🎯 Targeted testing
make test-unit          # Unit tests only
make test-mcp           # MCP server tests
make test-error         # Error handling tests

# 📈 Performance monitoring
python test_performance_benchmark.py

# 🎨 Format code  
uv run black src tests && uv run isort src tests

# 🔍 Type checking
uv run mypy src

📦 Build & Publish

# 🏗️ Build package
uv build

# ✅ Check integrity
uv run twine check dist/*

# 🚀 Publish to PyPI
uv run twine upload dist/*

🤝 Contributing

We ❤️ contributions! Whether it's:

• 🐛 Bug Reports: Found an issue? Let us know!
• ✨ Feature Requests: Have ideas? We want to hear them!
• 📝 Documentation: Help make our docs even better
• 🧪 Testing: Add tests, improve coverage
• 💻 Code: Submit PRs for new features or fixes

🚀 How to Contribute

1. 🍴 Fork the repository
2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
3. ✍️ Make your changes
4. ✅ Test everything (make test-parallel or make test-coverage)
5. 📝 Commit your changes (git commit -m 'Add amazing feature')
6. 📤 Push to the branch (git push origin feature/amazing-feature)
7. 🎉 Open a Pull Request

📊 Project Stats

🙏 Acknowledgments

• 🌩️ Vultr for their comprehensive cloud API
• 🤖 Anthropic for the Model Context Protocol specification
• 🐍 Python Community for amazing tools and libraries
• 🚀 FastMCP for the excellent MCP framework
• 👥 Contributors who make this project amazing

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.