DNS管理工具

一个全面的DNS记录管理工具,支持AI助手集成和Python直接操作,适用于Vultr DNS记录的管理。

  • by rsp2k
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 rsp2k/vultr-dns-mcp

使用说明

🌐 Vultr DNS MCP

一个全面的模型上下文协议(MCP)服务器,用于使用AI助手和直接Python集成管理Vultr DNS记录

安装 • 快速开始 • 特性 • 文档 • 贡献


✨ 特性

🤖 AI助手集成

  • MCP服务器 -完整的模型上下文协议支持
  • 克劳德集成 -与Claude AI直接集成
  • 自然语言 -了解复杂的DNS请求
  • 智能验证 -内置DNS记录验证

🐍 Python开发工具

  • 客户端库 -用于DNS操作的直接Python API
  • CLI工具 -DNS管理命令行界面
  • 异步支持 -完全异步/等待兼容性
  • 类型安全 -完整的类型提示和验证

🌐 完整的DNS管理

  • 所有记录类型 -A、AAAA、CNAME、MX、TXT、NS、SRV
  • 域操作 -创建、更新、删除域
  • 批量操作 -高效的批处理
  • TTL管理 -灵活的生存时间设置

📊 高级功能

  • 配置分析 -分析DNS设置并给出建议
  • 最佳实践 -内置DNS验证和建议
  • 错误处理 -全面的错误管理
  • 监控 -跟踪DNS更改和性能

🚀 快速开始

获取API密钥

从获取您的Vultr API密钥 Vultr控制面板.

export VULTR_API_KEY="your_vultr_api_key_here"

🤖 AI助手集成

克劳德集成

添加到您的 ~/.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使用情况

该软件包包括一个用于所有DNS操作的全面CLI:

# 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

可用的MCP工具

服务器提供全面的MCP资源和工具,任何兼容MCP的客户端都可以发现和使用:

工具 说明 示例用法
list_dns_domains() 列出所有域名 “显示我的所有域名”
get_dns_domain(domain) 获取域详细信息 “获取例如.com的信息”
create_dns_domain(domain, ip) 创建域名 “创建域名newsite.com”
delete_dns_domain(domain) 删除域 “删除旧的.example.com”
list_dns_records(domain) 列出记录 “显示mysite.com的DNS记录”
create_dns_record(...) 创建记录 “为www添加记录”
update_dns_record(...) 更新记录 “更改www的IP”
delete_dns_record(domain, record_id) 删除记录 “删除CNAME记录”
validate_dns_record(...) 验证记录 “检查此MX记录”
analyze_dns_records(domain) 分析配置 “分析mysite.com的DNS设置”

📋 支持的DNS记录类型

类型 描述 示例
A. IPv4地址 192.168.1.100
AAAA IPv6地址 2001:db8::1
别名 域名别名 example.com
导弹试验 邮件服务器 mail.example.com (需要优先权)
文本 文本数据 v=spf1 include:_spf.google.com ~all
纳秒 名称服务器 ns1.example.com
运动休闲车 服务记录 0 5 443 example.com (需要优先权)

🧪 发展

设置

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

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

运行测试

# Run all tests
pytest

# Run with coverage
pytest --cov=vultr_dns_mcp

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

代码质量

# format
black check --diff

# lint
ruff check src/

# Type checking TODO
# mypy src



📖 文档


🤝 贡献

我们欢迎捐款!请查看我们的 贡献指南 了解详情。

快速贡献设置

  1. 分叉 存储库
  2. 创建 特征分支(git checkout -b feature/amazing-feature)
  3. 制造 您的更改
  4. 测试 您的更改(pytest)
  5. 提交 您的更改(git commit -m 'Add amazing feature')
  6. 推 到分行(git push origin feature/amazing-feature)
  7. 打开 拉取请求

📝 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。


🆘 支持


🙏 致谢


⬆ 返回页首

由以下材料制成❤️ 通过rsp2k