dynadot

English | 한국어

dynadot-mcp

用于 Dynadot 域名注册商 API 的 MCP（Model Context Protocol）服务。通过 AI 助手管理域名、DNS 记录、联系人、转移等。

API 兼容性

此版本使用 API3。Dynadot 标记 API3 计划退役，但该公告中没有注明停用日期。其替代方案 REST v2 目前处于 Beta 阶段；Dynadot 警告称不保证兼容性，并建议在 Beta 阶段避免用于关键生产工作流。

此处尚未实现 REST v2，也没有自动回退机制。迁移需要单独处理 API 密钥／密钥签名、逐条命令的请求／响应映射、已接受但仍待处理的操作，以及将 API3 批量操作替换为单对象调用。在安全地替换此客户端的域名和付款操作之前，需要在沙盒中验证这些流程。只有在 Dynadot 继续支持 API3 期间，API3 凭据和沙盒模式才会继续可用。

DNS 和名称服务器

• set_dns 使用 set_dns2：主索引为 0..19，子域名索引为 0..99，并支持文档中说明的辅助 recordx 字段。请求发送前会拒绝未知字段和不完整的记录组。
• 默认情况下会替换 DNS。传入 add_dns_to_current_setting: "1" 可追加记录；空的 records 对象会清除记录。准备替换之前，请先读取现有 DNS。
• set_nameserver_ip 接受 server_id 和 ips（映射到 ip0..ip9）。原有的 host／ip 输入仍可使用：系统会将完全匹配的主机名解析为一个已注册的服务器 ID；如果没有匹配项或存在多个匹配项，则会报错且不会更新。
• delete_nameserver 接受 server_id（包括逗号分隔的 ID）或 server_domain（一个完全匹配的名称服务器主机名）。host 和 domain 仍是该精确主机名的别名，并非请求删除父域名下的所有名称服务器。
• 自由格式选项不能覆盖已配置的 API 密钥、命令，或明确选定的域名／联系人／文件夹。

适用场景

可以向 AI 助手提出这样的请求：

• “搜索可用域名” — 一次批量查询最多 100 个域名及其价格
• “注册新域名” — 注册一个域名或批量注册域名
• “更新我的域名的 DNS 记录” — 设置 A、AAAA、CNAME、MX、TXT、SRV 记录
• “将域名转移到 Dynadot” — 使用授权码发起转入
• “设置邮件转发” — 配置邮件转发或 MX 记录
• “续订我的域名” — 在到期前续订
• “锁定／解锁域名以进行转移” — 管理转移锁定状态
• “查看域名 WHOIS 信息” — 查看和管理 WHOIS 隐私设置

AI Agent 集成：请参阅 llms.txt 获取机器可读的摘要，或将 templates/CLAUDE.md／templates/AGENTS.md 复制到项目中，以自动发现 MCP。

功能

• 67 个工具，涵盖 Dynadot API3 域名管理命令
• 域名搜索、注册、续订、删除
• DNS 记录管理（A、AAAA、CNAME、MX、TXT、SRV）
• 名称服务器配置和 DNSSEC
• 联系人 CRUD 操作
• 域名转移（转入／转出）
• WHOIS 隐私、转发、锁定
• 文件夹整理
• 市场：拍卖、预订、刊登
• 账户信息和余额资源
• 用于测试的沙盒模式

安装

需要 Node.js 20 或更新版本，以匹配 MCP SDK 已安装的运行时依赖项。

npm install -g dynadot-mcp

或直接运行：

npx dynadot-mcp

配置

设置以下环境变量：

变量	必需	说明
DYNADOT_API_KEY	是	你的 Dynadot API 密钥（在此获取）
DYNADOT_SANDBOX	否	设置为 true 以使用沙盒 API（默认值：false）

在 Claude Code 中使用

添加到 Claude Code MCP 设置（~/.claude/settings.json 或项目的 .claude/settings.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）：

{
  "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	设置 DS 记录或 DNSKEY，或清除 DNSSEC
add_nameserver	添加新的名称服务器条目
set_nameserver_ip	更新名称服务器的 IP 地址
delete_nameserver	删除名称服务器 ID 或一个完全匹配的名称服务器主机名
list_registered_nameservers	列出所有已注册的名称服务器

set_dnssec 接受以下两组参数之一：key_tag、digest_type、digest 和 algorithm （来自 DNS 提供商的 DS 记录），或 flags、public_key 和 algorithm （DNSKEY）。这些值均为字符串。不完整或混合的记录会在联系 Dynadot 之前被拒绝。若要停用 DNSSEC，只传入 domain 和 clear: true。 set_dns 最多支持 20 条主记录和 100 条子域名记录（索引 0–99）。

联系人

工具	说明
create_contact	创建新联系人
edit_contact	编辑现有联系人
delete_contact	删除联系人
list_contacts	列出所有联系人或获取联系人详情
set_contact_regional_setting	设置欧盟/拉脱维亚/立陶宛区域联系人设置
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	完整域名列表

开发

git clone https://github.com/mikusnuz/dynadot-mcp.git
cd dynadot-mcp
npm install
npm run dev

许可证

MIT