🌐 Vultr DNS MCP

👁 PyPI version
👁 Python Support
👁 License: MIT
👁 Tests

A comprehensive Model Context Protocol (MCP) server for managing Vultr DNS records with AI assistants and direct Python integration

Installation • Quick Start • Features • Documentation • Contributing

✨ Features

🤖 AI Assistant Integration

• MCP Server - Full Model Context Protocol support

• Claude Integration - Direct integration with Claude AI

• Natural Language - Understand complex DNS requests

• Smart Validation - Built-in DNS record validation

🐍 Python Developer Tools

• Client Library - Direct Python API for DNS operations

• CLI Tool - Command-line interface for DNS management

• Async Support - Full async/await compatibility

• Type Safety - Complete type hints and validation

🌐 Complete DNS Management

• All Record Types - A, AAAA, CNAME, MX, TXT, NS, SRV

• Domain Operations - Create, update, delete domains

• Bulk Operations - Efficient batch processing

• TTL Management - Flexible time-to-live settings

📊 Advanced Features

• Configuration Analysis - Analyze DNS setup with recommendations

• Best Practices - Built-in DNS validation and suggestions

• Error Handling - Comprehensive error management

• Monitoring - Track DNS changes and performance

Related MCP server: ClawDaddy MCP Server

🚀 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

⬆ Back to Top

Made with ❤️ by rsp2k

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers