Porkbun域可用性MCP服务器
一种模型上下文协议（MCP）服务器，提供使用Porkbun API v3检查域可用性的工具。
特性
- 单域检查：检查单个域名的可用性
- 批量域检查：检查多个域的可用性（一次最多10个）
- 速率限制：尊重Porkbun的速率限制，内置延迟
- 错误处理：全面的错误处理和详细的消息
工具
1. check_domain_availability
检查单个域名的可用性，并返回详细的定价信息。
参数:
domain（string）：要检查可用性的域名
退货:
- 域可用性状态
- 定价信息
- 高级域名状态
- 第一年促销
- 续约和转让定价
- 费率限制信息
2. bulk_check_domains_availability
⚠️ 警告：同时检查多个域名的可用性。由于Porkbun API速率限制（每10秒检查一次），该工具的运行时间非常长。例如：5个域=~50秒，10个域=~100秒（1.7分钟）。与进行多个单域检查调用相比，批量工具提供了更好的用户体验和整合的结果。
参数:
domains（array）：要检查的域名数组（最多10个）
退货:
- 每个域的可用性状态的批量结果
- 可用域的定价信息
- 检查失败的个别错误消息
先决条件
- （建议使用v18或更高版本）
- Porkbon API证书(在此处生成)
设置
1.安装依赖项
npm install2.配置API凭据
使用环境变量或 .env 文件：
选项A：环境变量
export PORKBUN_API_KEY="your_api_key"
export PORKBUN_SECRET_API_KEY="your_secret_key"选项B：创建.env文件
创建一个 .env 项目根目录中的文件：
PORKBUN_API_KEY=your_api_key
PORKBUN_SECRET_API_KEY=your_secret_key选项C：自定义.env位置
运行服务器时传递自定义路径：
node build/index.js --dotenv-path /path/to/your/.env建筑
编译TypeScript代码：
npm run build这将在 build/ 目录。
运行服务器
标准启动
npm start自定义.env路径
node build/index.js --dotenv-path /path/to/your/.env发展模式
npm run dev服务器使用MCP进行通信 stdio 运输（标准输入/输出）。
使用Claude Desktop
要将此服务器与Claude Desktop一起使用，请将以下配置添加到您的“mcpServers”部分 claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"porkbun-domain-availability": {
"command": "node",
"args": [
"/absolute/path/to/mcp-porkbun-domain-availability/build/index.js",
"--dotenv-path",
"/absolute/path/to/mcp-porkbun-domain-availability/.env"
]
}
}
}将占位符路径替换为系统上的实际绝对路径。保存配置文件并重新启动Claude Desktop。
api信息
此服务器使用Porkbun API v3。有关API的更多信息：
速率限制
Porkbun API对域检查有速率限制。此服务器：
- 实现请求之间的自动延迟（10秒）
- 将批量检查限制为最多10个域
- 在响应中提供速率限制信息
错误处理
服务器为以下对象提供详细的错误消息：
- API凭据丢失或无效
- 网络连接问题
- 违反API费率限制
- 域名无效
- 服务器错误
许可证
MIT许可证-有关详细信息，请参阅项目存储库。