🌐 Vultr DNS MCP

✨ Features

🚀 Quick Start

Get Your API Key

Get your Vultr API key from the Vultr Control Panel.

export VULTR_API_KEY="your_vultr_api_key_here"

🤖 AI Assistant Integration

Claude Integration

Add to your ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vultr-dns": {
      "command": "uvx",
      "args": ["vultr-dns-mcp"],
      "env": {
        "VULTR_API_KEY": "your_vultr_api_key_here"
      }
    }
  }
}

🛠️ CLI Usage

The package includes a comprehensive CLI for all DNS operations:

# List domains
vultr-dns-mcp domains list

# Get domain information  
vultr-dns-mcp domains info example.com

# Create a new domain
vultr-dns-mcp domains create example.com 192.168.1.100

# List DNS records
vultr-dns-mcp records list example.com

# Add DNS records
vultr-dns-mcp records add example.com A www 192.168.1.100
vultr-dns-mcp records add example.com MX @ mail.example.com --priority 10

# Set up a website
vultr-dns-mcp setup-website example.com 192.168.1.100

# Set up email
vultr-dns-mcp setup-email example.com mail.example.com

Available MCP Tools

The server provides comprehensive MCP resources and tools that any MCP-compatible client can discover and use:

📋 Supported DNS Record Types

🧪 Development

Setup

# Clone the repository
git clone https://github.com/rsp2k/vultr-dns-mcp.git
cd vultr-dns-mcp

# Install development dependencies
pip install -e .[dev]

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=vultr_dns_mcp

# Run specific test file
pytest tests/test_server.py -v

Code Quality

# format
black check --diff

# lint
ruff check src/

# Type checking TODO
# mypy src

📖 Documentation

• API Documentation - Complete API reference
• MCP Protocol Guide - Understanding MCP
• Vultr API Docs - Vultr DNS API reference

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Setup

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Test your changes (pytest)
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

📝 License

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

🆘 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: Support Email

🙏 Acknowledgments

• Vultr for providing an excellent DNS API
• Anthropic for the Model Context Protocol
• FastMCP for MCP framework inspiration
• All our contributors