MCP Namecheap服务器
一种模型上下文协议(MCP)服务器,为域管理操作提供与Namecheap API的集成。
特性
我只添加了我使用的功能,我认为允许代理注册域名不是一个好主意。可以找到整套Namecheap API方法 这里.
- 获取域名列表:检索您Namecheap帐户中的所有域
- 检查域可用性:检查域名是否可供注册
- 设置自定义DNS:为您的域配置自定义名称服务器
- 可配置工具:启用/禁用特定工具以控制Cursor中可用的内容
先决条件
在使用此MCP服务器之前,您需要:
- Namecheap帐户要求:
- 您的帐户下至少有20个域名 - 您的账户余额为50美元 - 过去两年内花费50美元
- API访问设置:
- 在Namecheap仪表板中启用API访问 - 获取API密钥 - 将您的IP地址列入白名单
安装
- 克隆此存储库:
git clone
cd mcp-namecheap- 安装依赖项:
npm install- 构建项目:
npm run build配置
创建一个 .env 使用您的Namecheap凭据文件:
NAMECHEAP_API_USER=your_api_username
NAMECHEAP_API_KEY=your_api_key
NAMECHEAP_USERNAME=your_namecheap_username
NAMECHEAP_CLIENT_IP=your_whitelisted_ip_address或参考 mcp-config.json 显示所有可用环境变量的文件。
工具配置
您可以通过设置以下环境变量来启用/禁用特定工具:
NAMECHEAP_ENABLE_GETLIST-启用域列表检索(默认值:true)NAMECHEAP_ENABLE_CHECK-启用域可用性检查(默认值:true)NAMECHEAP_ENABLE_SETCUSTOM-启用自定义DNS配置(默认值:true)
将其中任何一个设置为 false 禁用相应的工具。
沙盒模式
为了进行测试,您可以使用Namecheap的沙盒环境:
NAMECHEAP_SANDBOX=true用法
运行服务器
npm start可用工具
1.获取域名列表(namecheap_get_domain_list)
返回您Namecheap帐户中所有域的列表,其中包含过期日期、自动续订状态和DNS配置等详细信息。
参数:无
2.检查域可用性(namecheap_check_domain_availability)
检查一个或多个域的注册可用性。
参数:
domains(array):要检查的域名数组(例如,\[“example.com”,“test.org”\])
3.设置自定义DNS(namecheap_set_custom_dns)
为域设置自定义名称服务器。请注意,URL转发、电子邮件转发和动态DNS等服务不适用于自定义名称服务器。
参数:
domain(string):域名(例如“example.com”)nameservers(array):名称服务器地址数组(1-12个名称服务器)
MCP客户端配置
要将此服务器与Cursor等MCP客户端一起使用,请在MCP配置中添加以下内容:
{
"mcpServers": {
"namecheap": {
"command": "node",
"args": ["path/to/mcp-namecheap/dist/index.js"],
"env": {
"NAMECHEAP_API_USER": "your_api_username",
"NAMECHEAP_API_KEY": "your_api_key",
"NAMECHEAP_USERNAME": "your_namecheap_username",
"NAMECHEAP_CLIENT_IP": "your_whitelisted_ip_address"
}
}
}
}发展
脚本
npm run build-构建TypeScript项目npm run dev-使用tsx在开发模式下运行npm start-运行已建项目
项目结构
src/
├── index.ts # Main MCP server implementation
├── namecheap-client.ts # Namecheap API client
└── types.ts # TypeScript type definitionsapi参考
此服务器使用以下Namecheap API终结点:
namecheap.domains.getList-检索域列表namecheap.domains.check-检查域可用性namecheap.domains.dns.setCustom-设置自定义名称服务器
有关更多信息,请参阅 名称便宜的API文档.
错误处理
该服务器包括全面的错误处理功能,用于:
- API凭据丢失或无效
- 网络连接问题
- 名称便宜API错误
- 无效参数
- 禁用工具
安全考虑
- 安全存储API凭据
- 更新您的IP白名单
- 使用环境变量进行敏感配置
- 考虑使用沙盒环境进行测试
许可证
麻省理工学院
