Porkbun DNS API 的 MCP 服务器。

通过模型上下文协议管理DNS记录、域名、DNSSEC、SSL证书等。

配置

将你的 Porkbun API 凭证设置为环境变量：

从Porkbun API访问页面获取你的API密钥。

只读模式（默认）

默认情况下，porkbun-mcp 以 只读模式运行以保证安全。写入操作 （创建、编辑、删除）会返回错误，直到被明确启用。

启用写操作

让猪弄脏并做出改变：

环境变量：

CLI 标志：

用途

直接运行UVX（无需安装）：

南南南交通

MCP 客户端配置

克劳德桌面

加到~/.config/claude/claude_desktop_config.json：

注意： 将 --get-muddy 从 args 中移除，以实现只读模式（为安全起见）。

克劳德密码 / 密码本

添加到~/.claude/settings.json：

VS 代码

在你的工作区中添加.vscode/mcp.json（或使用MCP: Add Server命令）：

开放代码

添加到你的opencode.json配置中：

可用工具

DNS

• dns_list - 列出域内所有DNS记录
• dns_get - 通过ID获取特定的DNS记录

porkbun-mcp

MCP server for the Porkbun DNS API.

Manage DNS records, domains, DNSSEC, SSL certificates, and more via the Model Context Protocol.

Configuration

Set your Porkbun API credentials as environment variables:

export PORKBUN_API_KEY="pk1_..."
export PORKBUN_SECRET_KEY="sk1_..."

Get your API keys from the Porkbun API Access page.

Read-Only Mode (Default)

By default, porkbun-mcp runs in read-only mode for safety. Write operations (create, edit, delete) will return an error until explicitly enabled.

Enabling Write Operations

To let the pig get muddy and make changes:

Environment variable:

export PORKBUN_GET_MUDDY=true

CLI flag:

uvx porkbun-mcp --get-muddy

Usage

Run directly with uvx (no installation required):

uvx porkbun-mcp

SSE transport

uvx porkbun-mcp --transport sse

MCP Client Configuration

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "porkbun": {
      "command": "uvx",
      "args": ["porkbun-mcp", "--get-muddy"],
      "env": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_KEY": "sk1_..."
      }
    }
  }
}

Note: Remove --get-muddy from args for read-only mode (recommended for safety).

Claude Code / Codex

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "porkbun": {
      "command": "uvx",
      "args": ["porkbun-mcp", "--get-muddy"],
      "env": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_KEY": "sk1_..."
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace (or use MCP: Add Server command):

{
  "servers": {
    "porkbun": {
      "command": "uvx",
      "args": ["porkbun-mcp", "--get-muddy"],
      "env": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_KEY": "sk1_..."
      }
    }
  }
}

OpenCode

Add to your opencode.json configuration:

{
  "mcp": {
    "porkbun": {
      "type": "local",
      "command": ["uvx", "porkbun-mcp", "--get-muddy"],
      "environment": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_KEY": "sk1_..."
      }
    }
  }
}

Available Tools

DNS

• dns_list - List all DNS records for a domain