Mcp Cloudflare Dns

mcp-cloudflare-dns

ゾーン、レコード、キャッシュ、ページルールを制御する必要があるオペレーター向けの Cloudflare DNS MCP サーバーです。変更のたびに Cloudflare ダッシュボードを開くことなく、MCP クライアントから操作できます。

リリース状況：ベータ版パッケージです。バージョンは pyproject.toml に記載されている 0.1.1 です。

手順を選ぶ

対象	こちらから開始	次に読む
Claude/Codex/Cursor にサーバーをインストールする方	docs/start-here.md	以下のクイックスタート
サーバーが操作できる範囲を確認する方	利用可能なツール	docs/architecture.md
パッケージングやリリースメタデータを監査する方	pyproject.toml	server.json

アーキテクチャ

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  E[CF_API_TOKEN] --> S
  S --> T[Tool handlers]
  T --> R[Retry wrapper]
  R --> A[Cloudflare API]
  A --> R --> T --> C

リクエストの流れ

flowchart TD
  Q[Operator asks for a DNS change] --> H[Selected MCP tool]
  H --> I[Load token and build client]
  I --> J{Cloudflare call succeeds?}
  J -- yes --> K[Return normalized JSON result]
  J -- retryable --> L[Backoff and retry]
  L --> J
  J -- no --> M[Return error payload]

クイックスタート

1. パッケージをインストールします。

python -m pip install mcp-cloudflare-dns

2. DNS 権限を持つトークンをエクスポートします。

export CF_API_TOKEN="your-cloudflare-api-token"

3. MCP クライアントに登録します。

{
  "mcpServers": {
    "cloudflare-dns": {
      "command": "uvx",
      "args": ["mcp-cloudflare-dns"],
      "env": {
        "CF_API_TOKEN": "your-cloudflare-api-token"
      }
    }
  }
}

利用可能なツール

ツールグループ	ツール	目的
ゾーン一覧	list_zones, get_zone, get_zone_settings	利用可能なゾーンと主要な設定を確認します
DNS レコード	list_dns_records, get_dns_record, create_dns_record, update_dns_record, delete_dns_record	レコードの読み取りと変更を行います
エッジ操作	purge_cache, list_page_rules	キャッシュされたコンテンツを無効化し、ページルールを確認します

delete_dns_record とキャッシュ全体に対する操作は、docs/start-here.md に記載されている破壊的操作用の環境変数フラグで引き続き制限されています。

実行時の証明

主張	証明
パッケージのエントリーポイントは安定しています	pyproject.toml の mcp-cloudflare-dns = "cf.server:main"
サーバーは汎用 CLI ではなく、MCP 専用です	cf/server.py の FastMCP("mcp-cloudflare-dns")
Cloudflare のエラーは再試行されます	cf/server.py の _call()
リリース成果物がビルドされています	dist/ の wheel と tarball がリポジトリにコミットされています

リポジトリの構成

パス	目的
cf/server.py	FastMCP のツール群、環境変数の読み込み、再試行ラッパー
pyproject.toml	パッケージのメタデータ、バージョン、スクリプトのエントリーポイント
server.json	MCP の検出に使われるレジストリ向けメタデータ
docs/start-here.md	セットアップ、環境変数、検証、よくある失敗
docs/architecture.md	コンポーネント構成とリクエストのライフサイクル

検証

チェック	コマンド
インポートをコンパイル	python -m compileall cf
パッケージをビルド	python -m build
README のリンクがローカルを参照	rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

ライセンス

MIT

新しいタスク向けのプロジェクト情報

タスク固有の仕様を確認するには INDEX.md を参照してください。製品の方向性が関係する場合は prompt.md を確認してください。過去の例によって現在のタスクが決まるわけではありません。