用途
domain-suite-mcp 是一个面向 AI 智能体的域名与 DNS 管理 MCP 服务器。它旨在填补智能体自主交付流程中的最后一环:智能体已经能够编写代码、配置基础设施并推送到生产环境,而域名与 DNS 管理此前仍需人工介入。该服务器让智能体可以端到端完成完整的域名生命周期操作,无需人工干预。
主要能力
- 作为统一抽象层,对接多个域名注册商与 DNS 服务商 API,对外暴露一致的 21 个 MCP 工具。
- 覆盖域名可用性查询、注册、DNS 管理、SSL 以及邮件认证(SPF、DKIM、DMARC)与 WHOIS。
- 支持的提供商包括 Porkbun、Namecheap、GoDaddy 和 Cloudflare。
- 完全无状态:无数据库、无持久认证、无需维护的服务器,每次调用直接从服务商 API 获取最新数据。
- 错误信息专为智能体设计,格式为
[ERROR_CODE] provider: what went wrong → what to do,说明问题原因及下一步操作,而非原始 API 错误码或晦涩的状态数字。 - 附带的五个预置 Claude Code 技能可直接调用:
/domain-check、/domain-register、/domain-dns-setup、/domain-email-setup、/domain-full-setup。
使用方式
- 域名可用性检查无需安装、零配置,通过公共 RDAP/WHOIS 协议即可立即使用。
- 通过环境变量添加服务商凭证后,可启用注册、DNS 管理、SSL 等更多功能。
- 支持全局安装,并可安装 Claude Code 技能:该命令会把技能复制到
~/.claude/skills/,需重启 Claude Code 以激活。 - 可打印适用于 Claude Desktop、Cursor、Windsurf 或任意 MCP 客户端的现成 JSON 配置片段。
- 配置方式示例:在
claude_desktop_config.json中添加(原文提供的是 JSON 配置片段,具体内容未在资料中给出);对于 Cursor / Windsurf / Kiro,则将配置加入对应客户端的 MCP 设置中。 - 也可先安装技能,再把 MCP 服务器添加到项目设置中,之后即可在 Claude Code 中直接调用技能。
- 完整工作流模式与提示词模板见
docs/SKILLS.md;完整工具参考(含 schema 与示例)见docs/TOOLS.md。
适用场景
- 需要让 AI 智能体自主完成从域名查询、注册到 DNS 配置、邮件认证设置的全流程自动化场景。
- 使用 Claude Code、Claude Desktop、Cursor、Windsurf、Kiro 等 MCP 兼容客户端的开发工作流。
- 希望统一管理多家注册商与 DNS 服务商,避免分别对接不同 API 的场合。
限制与注意事项
- GoDaddy 的 DNS 管理需要 10 个以上活跃域名,或订阅 Domain Pro 计划(约 240 美元/年)。
- Namecheap 需要在 Profile → Tools → API Access → Whitelisted IPs 中将服务器 IP 加入白名单,否则任何调用都无法生效。
- 推荐设置:在 Porkbun 或 Namecheap 注册域名,再将域名服务器指向 Cloudflare 做 DNS,兼顾注册便捷与 Cloudflare 快速的 DNS API。
- 项目欢迎贡献,相关设置、测试与拉取请求规范见
CONTRIBUTING.md。