Porkbun MCP Server

一个基于Model Context Protocol (MCP)的服务器，提供与Porkbun API交互的工具，用于管理域名、DNS记录、SSL证书等。

开发者工具电子商务与零售 #域名管理 #DNS服务 #API工具本地 .TypeScript

评分 : 2.5分

下载量 : 11

更新时间 : 2025-04-28

什么是Porkbun MCP服务器？

Porkbun MCP服务器是一个用于通过Model Context Protocol（MCP）协议控制Porkbun域名的接口。它允许AI模型或其他系统以自然语言指令管理域名记录、SSL证书等。

主要功能

通过MCP协议，用户可以执行以下操作： - 管理DNS记录 - 控制SSL证书 - 监控域名状态 - 批量操作多个域名

如何使用？

1. 安装并运行服务器 2. 配置Porkbun API密钥 3. 发送MCP指令进行操作 4. 处理响应并获取结果

Porkbun MCP 服务器文档

主要功能

DNS记录管理支持添加、修改和删除各种类型的DNS记录，包括A、CNAME、MX等。

SSL证书控制自动化管理域名的SSL证书，包括生成、更新和撤销操作。

域名监控实时监控域名状态，检测异常情况并及时通知管理员。

批量操作允许一次性处理多个域名或记录，提高管理效率。

优缺点分析

使用指南

使用示例

常见问题解答

故障排除

🚀 猪肉 bun MCP 服务器

这个项目提供了一个用于与 Porkbun 域名注册商交互的 Miracle Custom Protocol (MCP) 服务器。借助该服务器，你可以通过 Claude Desktop 应用或其他兼容工具实现对 Porkbun 域名的自动化管理。

🚀 快速开始

本仓库包含的 MCP 服务器可与 Porkbun 域名注册商进行交互，支持通过 Claude Desktop 等工具自动化管理域名。

✨ 主要特性

域名管理：支持购买、注销域名，刷新域名状态，获取所有注册域名列表。
DNS 记录管理：可获取当前 DNS 设置，添加、更新、删除 DNS 记录（支持 A、AAAA、CNAME、MX、TXT 类型）。
隐私保护：能够启用或禁用域名隐私保护功能。
功能拓展：后续还将开发 SSL 证书管理、Whois 隐私保护等功能。

📦 安装指南

克隆仓库

git clone https://github.com/miraclebakelaser/porkbun-mcp-server.git
cd porkbun-mcp-server

安装依赖项

npm install

配置 API 密钥

你可以通过以下多种方式提供 Porkbun 的 API Key 和 Secret Key（按优先级从高到低）：

系统环境变量：设置 PORKBUN_API_KEY 和 PORKBUN_SECRET_API_KEY 系统环境变量。
自定义 .env 文件：创建一个任意位置的 .env 文件，并通过命令行参数指定其路径（参见运行服务器部分）。
默认 .env 文件：在项目根目录下创建名为 porkbun-mcp-server/.env 的文件，内容如下：

PORKBUN_API_KEY=YOUR_API_KEY
PORKBUN_SECRET_API_KEY=YOUR_SECRET_API_KEY

请将 YOUR_API_KEY 和 YOUR_SECRET_API_KEY 替换为你的实际密钥。注意：如果计划将此项目提交到版本控制系统，请将 .env 文件添加到 .gitignore 中。

编译

将 TypeScript 代码编译为 JavaScript：

npm run build

这将在 build/ 目录下生成可执行的 JavaScript 文件。

运行服务器

标准启动方式：使用默认 .env 文件或系统环境变量：

npm start
# 或直接运行：
node build/index.js

自定义 .env 路径启动：通过 --dotenv-path 或 -p 命令行参数指定 .env 文件路径：

node build/index.js --dotenv-path /path/to/your/.env
# 或简写为：
node build/index.js -p /path/to/your/.env

开发模式：使用 dev 脚本监视文件变化并自动重建和重启：

# 默认 `.env` 启动
npm run dev

# 自定义 `.env` 路径启动
npm run dev -- --dotenv-path /path/to/your/.env
# 或
npm run dev -- -p /path/to/your/.env

服务器使用 MCP stdio 传输协议（标准输入输出）进行通信。

💻 使用示例

在 Claude Desktop 中使用

要将此服务器与 Claude Desktop 应用一起使用，请在 "mcpServers" 配置下添加以下内容：

"Porkbun":
{
  "name": "Porkbun",
  "type": "custom",
  "url": "file://path/to/porkbun-mcp-server/build/index.js"
}

确保服务器保持运行状态，Claude Desktop 将自动连接。

📚 详细文档

完整的 API 文档可以在 MCP 协议仓库中找到。

📄 许可证

MIT License

版权 (c) 2023年 miraclebakelaser

特此许可任何个人和组织使用、复制、修改、合并、发布、分发、 sublicense，以及制造和销售 derivative works 的权利，但需遵守以下条件：

1. 在分发或发表的衍生作品中保留上述版权声明、本许可声明以及下文中的免责声明。
2. 不对保修承担任何责任。

由于软件有可能存在缺陷，导致任何形式的损害或其他问题（包括但不限于直接、间接、附带或后果性损害），作者或版权持有人概不负责。