GoDaddy MCP

godaddy-mcp

一个用于管理 GoDaddy DNS 记录的 Model Context Protocol（MCP） 服务。AI 助手（Claude 等）可以通过它列出、添加、替换和删除 GoDaddy 账户中任意域名的 DNS 记录。

目录

• 安装
• 配置
• 使用方法
• 工具
• 测试
• 贡献
• 行为准则
• 许可证

安装

选项 A — PyPI（推荐）

需要 uv（Python 3.11+）。

uvx godaddy-mcp

无需克隆或配置路径。

选项 B — 从源代码安装

git clone https://github.com/davidcjw/godaddy-mcp
cd godaddy-mcp
uv sync

配置

1. 获取 GoDaddy API 凭据

在 developer.godaddy.com 创建 Production API 密钥（选择 Production，而非 OTE）。

2. 注册到 Claude Code

将以下内容添加到 ~/.claude.json 的 mcpServers 部分：

使用 PyPI 安装（推荐）：

"godaddy-dns": {
  "command": "uvx",
  "args": ["godaddy-mcp"],
  "env": {
    "GODADDY_API_KEY": "your_api_key",
    "GODADDY_API_SECRET": "your_api_secret"
  }
}

使用源代码安装：

"godaddy-dns": {
  "command": "/path/to/godaddy-mcp/.venv/bin/python",
  "args": ["/path/to/godaddy-mcp/server.py"],
  "env": {
    "GODADDY_API_KEY": "your_api_key",
    "GODADDY_API_SECRET": "your_api_secret"
  }
}

重启 Claude Code 以激活服务。

3. 其他 MCP 客户端

直接运行服务：

GODADDY_API_KEY=your_key GODADDY_API_SECRET=your_secret uvx godaddy-mcp
# or from source:
GODADDY_API_KEY=your_key GODADDY_API_SECRET=your_secret uv run python server.py

使用方法

注册后，Claude（或任何 MCP 客户端）便可通过对话管理 DNS 记录：

“为 app.example.com 添加一条指向 cname.vercel-dns.com 的 CNAME 记录”

“列出 example.com 的所有 A 记录”

“删除 example.com 中的 TXT 记录 _vercel”

工具

工具	描述
list_dns_records	列出域名的所有记录，可选按类型和/或名称筛选
add_dns_record	添加记录，不覆盖相同类型的现有记录（PATCH）
replace_dns_records	覆盖指定类型和名称的所有记录——需要确保只有一条记录时使用（PUT）。传入 dry_run=true 可预览变更而不实际应用
delete_dns_record	删除与指定类型和名称匹配的所有记录。传入 dry_run=true 可预览删除而不实际执行
check_domain_availability	检查域名是否可以注册，并显示价格和货币

安全提示： 破坏性工具 replace_dns_records 和 delete_dns_record 支持可选参数 dry_run（默认值为 false）。当 dry_run=true 时，工具会返回将要发生的变更描述，且不会调用 GoDaddy API，适合在正式提交变更前预览。

支持的记录类型： A、AAAA、CNAME、MX、TXT、NS、SRV、CAA，以及 GoDaddy API 支持的其他类型。

测试

测试使用 respx 模拟所有 HTTP 流量，不会发起真实的 GoDaddy API 调用。安装开发依赖并运行测试套件：

uv sync
uv run pytest

持续集成会通过 GitHub Actions 在每次推送和拉取请求时运行相同的测试套件。

贡献

欢迎贡献！请先提交议题，讨论你希望进行的更改。

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/your-feature）
3. 提交更改（git commit -m 'feat: describe change'）
4. 推送并创建拉取请求

提交 PR 前，请确保测试通过（uv run pytest），且服务能够正常启动（uv run python server.py）。

行为准则

本项目遵循 Contributor Covenant v2.1。参与本项目即表示你同意共同维护友好、无骚扰的环境。

许可证

本项目根据 MIT 许可证分发。详情请参阅 LICENSE。