vultr-dns-mcp 1.0.2

A comprehensive Model Context Protocol (MCP) server for managing Vultr DNS records

🌐 Vultr DNS MCP

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

---

🚀 Quick Start

Installation

# Install from PyPI
pip install vultr-dns-mcp

# Or install with development dependencies
pip install vultr-dns-mcp[dev]

Get Your API Key

Get your Vultr API key from the Vultr Control Panel.

export VULTR_API_KEY="your_vultr_api_key_here"

Start the MCP Server

# Start the MCP server for AI assistant integration
vultr-dns-mcp server

---

🛠️ 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

---

🤖 AI Assistant Integration

Claude Integration

Add to your ~/.config/claude/mcp.json:

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

Available MCP Tools

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

Tool	Description	Example Usage
list_dns_domains()	List all domains	"Show me all my domains"
get_dns_domain(domain)	Get domain details	"Get info for example.com"
create_dns_domain(domain, ip)	Create domain	"Create domain newsite.com"
delete_dns_domain(domain)	Delete domain	"Remove old.example.com"
list_dns_records(domain)	List records	"Show DNS records for mysite.com"
create_dns_record(...)	Create record	"Add A record for www"
update_dns_record(...)	Update record	"Change the IP for www"
delete_dns_record(domain, record_id)	Delete record	"Remove the CNAME record"
validate_dns_record(...)	Validate record	"Check this MX record"
analyze_dns_records(domain)	Analyze configuration	"Analyze DNS setup for mysite.com"

---

📋 Supported DNS Record Types

Type	Description	Example
A	IPv4 address	192.168.1.100
AAAA	IPv6 address	2001:db8::1
CNAME	Domain alias	example.com
MX	Mail server	mail.example.com (requires priority)
TXT	Text data	v=spf1 include:_spf.google.com ~all
NS	Name server	ns1.example.com
SRV	Service record	0 5 443 example.com (requires priority)

---

Error Handling

All operations include comprehensive error handling:

result = await client.add_a_record("example.com", "www", "192.168.1.100")
if "error" in result:
    print(f"Error: {result['error']}")
else:
    print(f"Success: Created record {result['id']}")

---

🧪 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