Porkbun MCP

🚀 porkbun-mcp

Porkbun DNS API用のMCPサーバーです。 モデルコンテキストプロトコルを通じて、DNSレコード、ドメイン、DNSSEC、SSL証明書などを管理できます。

🚀 クイックスタート

設定

Porkbun APIの認証情報を環境変数として設定します。

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

APIキーはPorkbun APIアクセスページから取得できます。

読み取り専用モード（デフォルト）

デフォルトでは、porkbun-mcpは安全のために読み取り専用モードで実行されます。書き込み操作（作成、編集、削除）は明示的に有効にするまでエラーを返します。

書き込み操作の有効化

変更を加えるには、以下の方法で書き込み操作を有効にします。

環境変数を使用する場合

export PORKBUN_GET_MUDDY=true

CLIフラグを使用する場合

uvx porkbun-mcp --get-muddy

実行方法

uvxを使って直接実行できます（インストール不要）。

uvx porkbun-mcp

SSEトランスポートを使用する場合

uvx porkbun-mcp --transport sse

💻 使用例

MCPクライアントの設定

Claude Desktop

~/.config/claude/claude_desktop_config.jsonに以下を追加します。

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

⚠️ 重要提示 安全のため、読み取り専用モードで使用する場合は--get-muddyをargsから削除してください。

Claude Code / Codex

~/.claude/settings.jsonに以下を追加します。

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

VS Code

ワークスペースの.vscode/mcp.jsonに以下を追加するか、MCP: Add Serverコマンドを使用します。

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

OpenCode

opencode.json設定ファイルに以下を追加します。

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

📚 詳細ドキュメント

利用可能なツール

DNS

• dns_list - ドメインのすべてのDNSレコードをリスト表示
• dns_get - IDで特定のDNSレコードを取得
• dns_get_by_name_type - サブドメインとタイプでDNSレコードを取得
• dns_create - 新しいDNSレコードを作成
• dns_edit - IDでDNSレコードを編集
• dns_edit_by_name_type - サブドメインとタイプでDNSレコードを編集
• dns_delete - IDでDNSレコードを削除
• dns_delete_by_name_type - サブドメインとタイプでDNSレコードを削除

ドメイン

• domains_list - アカウント内のすべてのドメインをリスト表示
• domains_get_nameservers - ドメインのネームサーバーを取得
• domains_update_nameservers - ドメインのネームサーバーを更新
• domains_get_url_forwards - URL転送ルールを取得
• domains_add_url_forward - URL転送ルールを追加
• domains_delete_url_forward - URL転送ルールを削除
• domains_check_availability - ドメインの可用性と価格を確認
• domains_get_glue_records - ドメインのグルーレコードを取得

DNSSEC

• dnssec_list - ドメインのDNSSECレコードをリスト表示
• dnssec_create - DNSSECレコードを作成
• dnssec_delete - DNSSECレコードを削除

SSL

• ssl_retrieve - ドメインのSSL証明書バンドルを取得

価格

• pricing_get - すべての利用可能なTLDの価格を取得

ユーティリティ

• ping - APIの接続性をテストし、パブリックIPを取得

プロンプト

一般的なDNS操作をガイドする事前定義されたワークフローです。

• dns_setup - 新しいサーバーの基本的なDNSを設定（ルートA + wwwレコード）
• dns_audit - DNS設定の問題を監査（重複、欠落したメールレコード、低TTL）
• email_dns_setup - メールDNSを構成（MX、SPF、DKIM、DMARC）
• update_server_ip - 新しいサーバーIPに移行する際にDNSレコードを更新
• subdomain_setup - 新しいサブドメインのA/CNAMEレコードを作成

🔧 開発

# 依存関係のインストール
uv sync --dev

# すべてのチェックを実行
make check

# 個別のコマンド
make lint       # ruff check
make format     # ruff format
make typecheck  # ty check
make test       # pytest with coverage

📄 ライセンス

MIT