bunny.net CDN and Shield

bunny-mcp

bunny.net CDN サイトのデバッグと、bunny.net のウェブアプリケーションファイアウォール（WAF）である bunny Shield の管理を行う MCP サーバーです。

これは非公式プロジェクトです。bunny.net との提携関係はなく、同社から承認も受けていません。

プルゾーン（CDN サイト）、エッジルール、キャッシュのパージ、CDN 統計、オリジンエラーログ、および Shield（WAF 設定、カスタム WAF ルール、レート制限、ボット検出、WAF イベントログ）を扱います。DNS、ストレージ、Stream、エッジスクリプトには対応していません。これらについては、anvme/bunnycdn-mcp または Digitizers/bunny-mcp をご覧ください。

独自の特長

• ルールが実際にどう動作するかを説明します。 get_shield_zone は notes を返し、たとえばゾーンの WAF 実行モードが Log の場合、Block ルールはログを記録するだけであることを警告します。
• WAF イベントログを読み取ります。 shield_event_logs では、過去 72 時間に WAF がブロック、チャレンジ、またはログ記録した内容を、ルール、IP、JA4 フィンガープリントなどでグループ化して確認できます。
• 変更内容を報告します。 更新ツールは変更前後の差分を返します。update_pull_zone は、要求していないにもかかわらず bunny.net が変更した設定も一覧表示します。
• 応答を小さく保ちます。 プルゾーン、エッジルール、オリジンエラー、イベントログは要約されます。生の応答を取得するには detail: true を指定してください。
• 認証情報を隠します。 トークン認証キー、AWS 署名キー、TLS 証明書と秘密鍵、ログ転送トークン、エッジルールのトリガー内にある Cookie や Authorization の値は、<hidden> に置き換えられます。生の応答でも同様です。

必要条件

• Node.js 20 以降
• bunny.net アカウントの API キー。bunny.net ダッシュボードの Account settings > API key から取得できます。このキーはアカウントへのフルアクセスを許可します。

インストール

Claude Code：

claude mcp add bunny --env BUNNY_API_KEY=your-key -- npx -y @fullfatthings/bunny-mcp

その他の MCP クライアント（Claude Desktop など）：

{
  "mcpServers": {
    "bunny": {
      "command": "npx",
      "args": ["-y", "@fullfatthings/bunny-mcp"],
      "env": { "BUNNY_API_KEY": "your-key" }
    }
  }
}

設定

変数	説明
BUNNY_API_KEY	必須です。bunny.net アカウントの API キーを指定します。
BUNNY_READONLY	1 に設定すると、読み取りツールのみが登録されます。この場合、書き込みツールはツール一覧に表示されないため、アシスタントは呼び出せません。

ツール

読み取りツール：

ツール	用途
list_pull_zones	ID、オリジン、ホスト名とともにプルゾーンを一覧表示します。
get_pull_zone	1 つのプルゾーンについて、ホスト名、読みやすい形式のエッジルール、キャッシュ、オリジン、セキュリティの設定を取得します。
cdn_statistics	帯域幅、リクエスト数、キャッシュヒット率、エラー応答を取得します。
origin_errors	1 日分の、bunny.net からオリジンへの失敗したリクエストを、エラー別の件数とともに取得します。
get_shield_zone	WAF 設定、カスタムルール、レート制限、ボット検出を notes とともに取得します。
shield_event_logs	過去 72 時間に WAF がブロック、チャレンジ、またはログ記録したリクエストを取得します。

書き込みツール（BUNNY_READONLY=1 の場合は登録されません）：

ツール	用途
update_pull_zone	プルゾーンの設定を変更します。
purge_cache	1 つの URL またはプルゾーン全体のキャッシュをパージします。
save_edge_rule	エッジルールを作成または更新します。
set_edge_rule_enabled	エッジルールを有効または無効にします。
delete_edge_rule	エッジルールを削除します。
update_shield_zone	リストへの個別ルール ID の追加や削除など、WAF 設定を変更します。
update_bot_detection	ボット検出のモードと感度を変更します。
save_waf_rule	カスタム WAF ルールを作成または更新します。
save_rate_limit	レート制限を作成または更新します。
delete_shield_rule	カスタム WAF ルールまたはレート制限を削除します。

新しい WAF ルールを安全にテストするには、アクションを Log にして保存し、shield_event_logs を確認してから、アクションを Block にして再度保存してください。

開発

npm install
npm test

リリースするには、npm version patch（または minor、major）を実行します。package.json と server.json が更新され、コミット、タグ付け、プッシュが行われます。タグをきっかけに GitHub Action が起動し、npm と MCP レジストリに公開します。

ライセンス

MIT。詳細は LICENSE をご覧ください。