namecheap-api-mcp

namecheap-api-mcp

用于 Namecheap API 的 MCP 服务，可直接通过 AI 助手管理域名、DNS、联系人、注册商锁定，并查看 SSL 证书和定价。

专为 Claude Code 及任何兼容 MCP 的 AI 工具打造。

这是 Rex Jones 的 The SEO Engine 工具集的一部分，为代理机构和企业提供 AI 驱动的 SEO 和社交媒体工具。

安全模型

此服务仅提供读取和安全写入工具。它可以读取你的账户信息，并更改 DNS／名称服务器／转发／锁定配置（均可撤销），但有意排除任何会花费资金或不可逆的操作：不提供域名注册、续费、重新激活、转移、购买／激活 SSL、充值或账户／地址修改功能。如果有需要，你可以派生此项目并添加这些功能。

快速开始

1. 启用 Namecheap API 访问权限

1. 前往 Profile → Tools → Namecheap API Access 并将其切换为开启。（生产环境访问权限要求账户符合条件：拥有 20 个以上域名，或余额不少于 $50，或历史消费总额不少于 $50。）
2. 复制你的 API 密钥。
3. 将运行此服务的机器的公网 IPv4 地址加入白名单（API 会对任何不在白名单中的 IP 返回错误 1011150）。

2. 配置 MCP 客户端

{
  "mcpServers": {
    "namecheap": {
      "command": "npx",
      "args": ["-y", "namecheap-api-mcp"],
      "env": {
        "NAMECHEAP_API_USER": "your_username",
        "NAMECHEAP_API_KEY": "your_api_key",
        "NAMECHEAP_CLIENT_IP": "your.whitelisted.ip.v4"
      }
    }
  }
}

选项：克隆并构建

git clone https://github.com/lanternrow/namecheap-api-mcp.git
cd namecheap-api-mcp
npm install
npm run build

然后将客户端指向 node /path/to/namecheap-api-mcp/dist/index.js。对于本地凭据，你可以保留一个被 git 忽略的 .env 文件（复制 .env.example），并使用 Node 的原生标志启动：node --env-file=.env dist/index.js。

环境变量

变量	必需	说明
NAMECHEAP_API_USER	是	你的 Namecheap 账户用户名（API 用户）。
NAMECHEAP_API_KEY	是	从 Profile → Tools → API Access 获取的 API 密钥。机密信息。
NAMECHEAP_CLIENT_IP	是	此机器已加入白名单的公网 IPv4 地址。
NAMECHEAP_USERNAME	否	默认为 NAMECHEAP_API_USER；仅转售商子用户的值会不同。
NAMECHEAP_ENVIRONMENT	否	production（默认）或 sandbox。

工具

读取

工具	说明
check_connection	验证凭据和 IP 白名单；返回账户余额摘要。
list_domains	列出域名及其到期时间、锁定状态、自动续费状态和 WhoisGuard 状态（支持分页／搜索）。
get_domain_info	获取某个域名的详细信息。
check_domains	检查域名可用性和溢价定价（每次最多 50 个）。
get_domain_contacts	获取注册人／技术／管理员／辅助账单联系人。
get_registrar_lock	获取注册商锁定状态。
get_dns_hosts	获取域名的所有 DNS 主机记录。
get_nameservers	获取名称服务器，以及是否正在使用 Namecheap DNS。
get_email_forwarding	获取电子邮件转发规则。
get_pricing	获取某类产品的 Namecheap 定价（缓存结果）。
list_ssl_certificates	列出 SSL 证书及其类型、主机、状态和到期时间。

安全写入（仅限配置，不会产生费用）

工具	说明
set_dns_hosts	替换所有主机记录（具有破坏性：未提供的记录会被删除——请发送完整记录集）。
set_default_dns	将域名切换为 Namecheap 的默认名称服务器。
set_custom_nameservers	将域名指向自定义名称服务器。
set_email_forwarding	设置电子邮件转发规则。
set_registrar_lock	在注册商处锁定／解锁域名。

注意事项

• set_dns_hosts 根据 API 设计会删除现有记录。 Namecheap 的 setHosts 会删除调用中未包含的所有记录。请务必先读取当前记录（get_dns_hosts），合并要做的更改，然后发送完整记录集。
• 错误会返回 HTTP 200。 Namecheap API 会在 XML 正文中（Status="ERROR"）而非 HTTP 状态码中指示失败。此服务会解析该信息，并抛出包含 Namecheap 错误编号和消息的真实错误。
• 白名单客户端 IP 仅支持 IPv4。

安全

• 凭据仅从环境变量中读取，不会由此服务硬编码、记录日志或写入磁盘。
• API 密钥会通过查询字符串传递（这是 Namecheap 的设计）；此服务绝不会记录请求 URL 或密钥，错误消息仅显示 Namecheap 错误编号和文本。

许可证

MIT © Rex Jones