Porkbun DNS 🐷

io.github.major由 GitHub 帳號 major 發布v1.1.2更新於 Oct 24, 2026

Manage DNS records, domains, DNSSEC, SSL certificates via MCP

發布方自己的服務:Porkbun (official)

概覽

AI 產生的概覽

讓助理讀取,並在啟用後修改 Porkbun 的 DNS 記錄、網域、DNSSEC 與 SSL 憑證。

可以做什麼
包裝 Porkbun DNS API,讓助理可以列出、查詢、建立、編輯與刪除 DNS 記錄,也支援依子網域與類型查詢。還能列出網域、讀取與更新名稱伺服器、管理 URL 轉送規則、查詢網域可用性與價格,並處理 DNSSEC 記錄與取得 SSL 憑證。內建提示詞涵蓋常見流程,例如初始 DNS 設定、DNS 稽核、郵件 DNS、伺服器 IP 遷移與子網域建立。
適用情境
適合在 Porkbun 管理網域、希望助理不必登入網頁控制台就能查看或修改 DNS、名稱伺服器、轉送、DNSSEC 或憑證的情境。適用於日常記錄修改、遷移與稽核;若 DNS 託管在其他服務商則幫助不大。
執行需求
以本機 Python 套件(pypi porkbun-mcp)執行,通常透過 uvx 啟動,並在桌面 MCP 用戶端中設定。需要 Porkbun API 金鑰與私密金鑰,透過環境變數 PORKBUN_API_KEY 與 PORKBUN_SECRET_KEY 提供,並需要連線至 Porkbun API 的網路。
安裝前請注意
PORKBUN_API_KEY 與 PORKBUN_SECRET_KEY 可控制你的 Porkbun 帳戶,並會存放在用戶端設定中。寫入操作預設關閉,只有在將 PORKBUN_GET_MUDDY 設為 true 或傳入 --get-muddy 參數後才會生效;啟用後助理可建立、編輯、刪除 DNS 記錄、變更名稱伺服器,以及刪除轉送或 DNSSEC 記錄。除非確實需要修改,否則請保持唯讀模式。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Porkbun DNS 🐷,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

porkbun-mcp

MCP server for the Porkbun DNS API.

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

[CI] [codecov] [PyPI version] [Python 3.13+] [License: MIT]

Configuration

Set your Porkbun API credentials as environment variables:

bash
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:

bash
export PORKBUN_GET_MUDDY=true

CLI flag:

bash
uvx porkbun-mcp --get-muddy

Usage

Run directly with uvx (no installation required):

bash
uvx porkbun-mcp

SSE transport

bash
uvx porkbun-mcp --transport sse

MCP Client Configuration

Claude Desktop

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

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:

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):

json
{  "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:

json
{  "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
  • dns_get - Get a specific DNS record by ID
  • dns_get_by_name_type - Get DNS records by subdomain and type
  • dns_create - Create a new DNS record
  • dns_edit - Edit a DNS record by ID
  • dns_edit_by_name_type - Edit DNS records by subdomain and type
  • dns_delete - Delete a DNS record by ID
  • dns_delete_by_name_type - Delete DNS records by subdomain and type

Domains

  • domains_list - List all domains in your account
  • domains_get_nameservers - Get nameservers for a domain
  • domains_update_nameservers - Update nameservers for a domain
  • domains_get_url_forwards - Get URL forwarding rules
  • domains_add_url_forward - Add a URL forwarding rule
  • domains_delete_url_forward - Delete a URL forwarding rule
  • domains_check_availability - Check domain availability and pricing
  • domains_get_glue_records - Get glue records for a domain

DNSSEC

  • dnssec_list - List DNSSEC records for a domain
  • dnssec_create - Create a DNSSEC record
  • dnssec_delete - Delete a DNSSEC record

SSL

  • ssl_retrieve - Retrieve the SSL certificate bundle for a domain

Pricing

  • pricing_get - Get pricing for all available TLDs

Utility

  • ping - Test API connectivity and get your public IP

Prompts

Pre-defined workflows to guide common DNS operations:

  • dns_setup - Set up basic DNS for a new server (root A + www records)
  • dns_audit - Audit DNS configuration for issues (duplicates, missing email records, low TTLs)
  • email_dns_setup - Configure email DNS (MX, SPF, DKIM, DMARC)
  • update_server_ip - Update DNS records when migrating to a new server IP
  • subdomain_setup - Create A/CNAME records for a new subdomain

Development

bash
# Install dependenciesuv sync --dev
# Run all checksmake check
# Individual commandsmake lint       # ruff checkmake format     # ruff formatmake typecheck  # ty checkmake test       # pytest with coverage

License

MIT

來源:README.md,提交 8ff5e1d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Porkbun 整合