内容
**中文** | [한국어](README.ko.md)
# dynadot-mcp
[](https://www.npmjs.com/package/dynadot-mcp)
[](https://lobehub.com/mcp/mikusnuz-dynadot-mcp)
Dynadot 域名注册商 API 的 MCP(模型上下文协议)服务器。管理域名、DNS 记录、联系人、转移等 — 所有操作均可通过 AI 助手完成。
## 使用场景
告诉你的 AI 助手:
- **"搜索可用域名"** — 批量检查最多 100 个域名及其价格
- **"注册新域名"** — 注册或批量注册域名
- **"更新域名 DNS 记录"** — 设置 A、AAAA、CNAME、MX、TXT、SRV 记录
- **"将域名转移到 Dynadot"** — 发起带有授权码的入站转移
- **"设置电子邮件转发"** — 配置电子邮件转发或 MX 记录
- **"续期域名"** — 在到期前续期
- **"锁定/解锁域名进行转移"** — 管理转移锁定状态
- **"查看域名 WHOIS 信息"** — 查看和管理 WHOIS 隐私设置
> **AI 代理集成**:参见 [`llms.txt`](llms.txt) 以获取机器可读的摘要,或复制 [`templates/CLAUDE.md`](templates/CLAUDE.md) / [`templates/AGENTS.md`](templates/AGENTS.md) 到您的项目中以进行自动 MCP 发现。
## 功能
- **60 种工具**,涵盖完整的 Dynadot API3(约 106 个命令)
- 域名搜索、注册、续期、删除
- DNS 记录管理(A、AAAA、CNAME、MX、TXT、SRV)
- 名称服务器配置和 DNSSEC
- 联系人 CRUD 操作
- 域名转移(进/出)
- WHOIS 隐私、转发、锁定
- 文件夹组织
- 市场:拍卖、回购、列表
- 账户信息和余额资源
- 用于测试的沙盒模式
## 安装
```bash
npm install -g dynadot-mcp
```
或直接运行:
```bash
npx dynadot-mcp
```
## 配置
设置以下环境变量:
| 变量 | 是否必需 | 描述 |
| --- | --- | --- |
| `DYNADOT_API_KEY` | 是 | 您的 Dynadot API 密钥([在此处获取](https://www.dynadot.com/account/domain/setting/api.html)) |
| `DYNADOT_SANDBOX` | 否 | 设置为 `true` 以使用沙盒 API(默认:`false`) |
## 与 Claude Code 配合使用
在您的 Claude Code MCP 设置中添加(`~/.claude/settings.json` 或项目 `.claude/settings.json`):
```json
{
"mcpServers": {
"dynadot": {
"command": "npx",
"args": ["-y", "dynadot-mcp"],
"env": {
"DYNADOT_API_KEY": "your_api_key_here"
}
}
}
}
```
## 与 Claude Desktop 配合使用
在您的 Claude Desktop 配置中添加(`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"dynadot": {
"command": "npx",
"args": ["-y", "dynadot-mcp"],
"env": {
"DYNADOT_API_KEY": "your_api_key_here"
}
}
}
}
```
## 可用工具
### 域名管理
| 工具 | 描述 |
| --- | --- |
| `search_domain` | 检查域名可用性(最多 100 个,含价格和语言选项) |
| `register_domain` | 注册新域名 |
| `bulk_register_domains` | 批量注册域名 |
| `get_domain_info` | 获取域名详细信息 |
| `list_domains` | 列出账户中的所有域名 |
| `renew_domain` | 续期域名 |
| `delete_domain` | 删除域名(宽限期内) |
| `restore_domain` | 恢复已删除的域名(赎回期内) |
| `push_domain` | 将域名推送到另一个 Dynadot 账户 |
### DNS
| 工具 | 描述 |
| --- | --- |
| `get_dns` | 获取域名的 DNS 记录 |
| `set_dns` | 设置 DNS 记录(A、AAAA、CNAME、MX、TXT 等) |
| `set_nameservers` | 配置名称服务器(最多 13 个) |
| `get_nameservers` | 获取当前名称服务器 |
| `register_nameserver` | 注册自定义名称服务器 |
| `get_dnssec` | 获取 DNSSEC 设置 |
| `set_dnssec` | 设置或清除 DNSSEC |
| `add_nameserver` | 添加新的名称服务器条目 |
| `set_nameserver_ip` | 更新名称服务器的 IP 地址 |
| `delete_nameserver` | 删除名称服务器(按主机名或域名) |
| `list_registered_nameservers` | 列出所有已注册的名称服务器 |
### 联系人
| 工具 | 描述 |
| --- | --- |
| `create_contact` | 创建新联系人 |
| `edit_contact` | 编辑现有联系人 |
| `delete_contact` | 删除联系人 |
| `list_contacts` | 列出所有联系人或获取详细信息 |
| `set_contact_regional_setting` | 设置 EU/LV/LT 区域联系人设置 |
| `manage_cn_audit` | 创建或检查 .cn 域名审计 |
| `set_reseller_verification` | 设置经销商 WHOIS 验证状态 |
### 转移
| 工具 | 描述 |
| --- | --- |
| `transfer_domain` | 发起域名转移 |
| `cancel_transfer` | 取消待处理的转移 |
| `get_transfer_status` | 检查转移状态 |
| `get_auth_code` | 获取转移授权码 / EPP 码(可选解锁和代码再生) |
| `authorize_transfer_away` | 批准出站转移 |
| `set_auth_code` | 设置转移授权码 |
| `manage_domain_push` | 查看 / 接受 / 拒绝域名推送请求 |
### 设置
| 工具 | 描述 |
| --- | --- |
| `set_privacy` | 设置 WHOIS 隐私(完全 / 部分 / 关闭) |
| `set_whois_contacts` | 设置 WHOIS 联系人 |
| `set_forwarding` | 设置 URL / 隐身转发 |
| `set_renew_option` | 设置自动续期选项 |
| `lock_domain` | 锁定或解锁域名以保护转移 |
| `set_domain_note` | 设置域名备注和文件夹 |
| `set_parking` | 启用域名停放 |
| `set_hosting` | 设置 Dynadot 主机(基本 / 高级) |
| `set_email_forward` | 设置电子邮件转发或 MX 记录 |
| `clear_domain_setting` | 清除特定域名服务设置 |
### 文件夹
| 工具 | 描述 |
| --- | --- |
| `create_folder` | 创建新文件夹 |
| `delete_folder` | 删除文件夹 |
| `list_folders` | 列出所有文件夹 |
| `set_folder_settings` | 将默认设置应用于文件夹(WHOIS、NS、DNS、转发等) |
| `rename_folder` | 重命名文件夹 |
### 账户
| 工具 | 描述 |
| --- | --- |
| `get_account_info` | 获取账户信息 |
| `get_account_balance` | 检查账户余额 |
| `set_account_defaults` | 设置默认账户设置 |
| `list_orders` | 列出订单历史记录 |
| `get_order_status` | 按 ID 检查订单状态 |
| `check_processing` | 检查待处理操作 |
| `list_coupons` | 列出可用优惠券 |
| `get_tld_price` | 获取 TLD 定价信息 |
### 市场
| 工具 | 描述 |
| --- | --- |
| `get_auctions` | 列出开放 / 关闭的拍卖 |
| `place_bid` | 对拍卖进行竞价 |
| `manage_backorders` | 添加 / 删除 / 列出回购请求 |
| `set_for_sale` | 列出域名待售 |
| `get_marketplace_listings` | 查看市场列表 |
| `get_auction_details` | 获取拍卖详情和竞价历史记录 |
| `manage_backorder_auctions` | 查看 / 竞价回购拍卖 |
| `buy_expired_domain` | 浏览 / 购买过期域名清仓 |
| `buy_it_now` | 购买市场列表 |
| `confirm_marketplace_action` | 确认 Afternic / Sedo 操作 |
## 资源
| URI | 描述 |
| --- | --- |
| `dynadot://account` | 账户信息快照 |
| `dynadot://balance` | 当前账户余额 |
| `dynadot://domains` | 完整的域名列表 |
## 开发
```bash
git clone https://github.com/mikusnuz/dynadot-mcp.git
cd dynadot-mcp
npm install
npm run dev
```
## 许可证
MIT