MCP Cloudflare

io.github.crunchtools由 GitHub 帳號 crunchtools 發布v0.1.1更新於 Oct 24, 2026

Secure MCP server for Cloudflare DNS, Transform Rules, and Page Rules

發布方自己的服務:Cloudflare

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓助理透過 Cloudflare API 管理區域、DNS 記錄、轉換規則、頁面規則、Access 應用程式與快取。

可以做什麼
列出區域,並依 ID 或網域名稱取得區域詳細資料;列出、取得、建立、更新與刪除常見類型的 DNS 記錄,支援篩選。列出並設定請求標頭、回應標頭與 URL 重寫轉換規則。列出、建立、更新與刪除用於重新導向、快取設定與 SSL 模式的頁面規則。檢視 Zero Trust Access 組織、應用程式與原則,並建立或刪除 Access 應用程式與原則。依 URL、標籤、主機、前綴或全部清除快取。
適用情境
適合讓助理檢視或修改自己網域的 Cloudflare 設定,例如新增 DNS 記錄、設定安全回應標頭、調整頁面規則或清除快取,而不必開啟主控台。
執行需求
以 stdio 方式在本機執行,可透過 uvx 或 pip 安裝 Python 套件,也可使用容器映像。需要透過環境變數 CLOUDFLARE_API_TOKEN 提供 Cloudflare API 權杖,並依所需操作設定權限(文件提供唯讀、僅 DNS 與完整管理三種權限組合)。需要連線至 Cloudflare API 的網路存取。
安裝前請注意
此權杖可實際控制你的 Cloudflare 帳戶;應限定在所需區域與權限,盡量使用唯讀或僅 DNS 的權限組合。許多工具會寫入或刪除:DNS 記錄、頁面規則、轉換規則、Access 應用程式與原則以及快取清除都會影響線上流量。README 表示權杖保留在本機,不會傳送給第三方服務。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

MCP Cloudflare CrunchTools

A secure MCP (Model Context Protocol) server for Cloudflare DNS, Transform Rules, Page Rules, and cache management.

Overview

This MCP server is designed to be:

  • Secure by default - Threat modeling, input validation, and token protection
  • No third-party services - Runs locally via stdio, your API token never leaves your machine
  • Cross-platform - Works on Linux, macOS, and Windows
  • Automatically updated - GitHub Actions monitor for CVEs and update dependencies
  • Containerized - Available at quay.io/crunchtools/mcp-cloudflare built on Hummingbird Python base image

Naming Convention

ComponentName
GitHub repocrunchtools/mcp-cloudflare
Containerquay.io/crunchtools/mcp-cloudflare
Python package (PyPI)mcp-cloudflare-crunchtools
CLI commandmcp-cloudflare-crunchtools
Module importmcp_cloudflare_crunchtools

Why Hummingbird?

The container image is built on the Hummingbird Python base image from Project Hummingbird, which provides:

  • Minimal CVE exposure - Hummingbird images are built with a minimal package set, dramatically reducing the attack surface compared to general-purpose images
  • Regular updates - Security patches are applied promptly, keeping CVE counts low
  • Optimized for Python - Pre-configured Python environment with uv package manager for fast, reproducible builds
  • Production-ready - Designed for production workloads with proper signal handling and non-root user defaults

This means your MCP server runs in a hardened environment with fewer vulnerabilities than typical Python container images

Features

Zone Management (2 tools)

  • list_zones - List all zones accessible by your API token
  • get_zone - Get zone details by ID or domain name

DNS Records (5 tools)

  • list_dns_records - List DNS records with filtering
  • get_dns_record - Get a single DNS record
  • create_dns_record - Create A, AAAA, CNAME, MX, TXT, NS, SRV, CAA records
  • update_dns_record - Update existing records
  • delete_dns_record - Delete records

Transform Rules (6 tools)

  • list_request_header_rules / set_request_header_rules - Modify request headers
  • list_response_header_rules / set_response_header_rules - Modify response headers
  • list_url_rewrite_rules / set_url_rewrite_rules - URL path/query rewrites

Page Rules (4 tools)

  • list_page_rules - List all page rules
  • create_page_rule - Create redirects, cache settings, SSL modes
  • update_page_rule - Modify existing rules
  • delete_page_rule - Remove rules

Access (8 tools)

  • get_access_organization - The Zero Trust organization and its team login domain
  • list_access_apps / get_access_app - Applications on a zone, with their audience tags
  • create_access_app / delete_access_app - Put a hostname behind an Access login, or take it out
  • list_access_policies - Who an application admits
  • create_access_policy / delete_access_policy - Allow, deny or bypass by email, email domain, IP or everyone

Cache Management (1 tool)

  • purge_cache - Purge by URL, tag, host, prefix, or everything

Installation

With uvx (Recommended)

bash
uvx mcp-cloudflare-crunchtools

With pip

bash
pip install mcp-cloudflare-crunchtools

With Container

bash
podman run -e CLOUDFLARE_API_TOKEN=your_token \    quay.io/crunchtools/mcp-cloudflare

Configuration

Creating a Cloudflare API Token

  1. Navigate to API Tokens

  2. Configure Token Name

    • Enter: mcp-cloudflare-crunchtools
  3. Configure Permissions

    The Permissions section has three dropdowns per row:

    • First dropdown: Resource type (Account or Zone)
    • Second dropdown: Specific permission category
    • Third dropdown: Access level (Read or Edit)

    Click "+ Add more" to add each permission row. For full management, add:

    ResourcePermissionAccess
    ZoneZoneRead
    ZoneDNSEdit
    ZonePage RulesEdit
    ZoneTransform RulesEdit
    ZoneCache PurgePurge
    AccountAccess: Apps and PoliciesEdit
    AccountAccess: Organizations, Identity Providers, and GroupsRead
  4. Configure Zone Resources

    • First dropdown: Select "Include"
    • Second dropdown: Select "All zones" or "Specific zone"
  5. Configure Client IP Address Filtering (Optional)

    • Click "Use my IP" button to restrict token to your current IP
  6. Create and Copy Token

    • Click "Continue to summary" → "Create Token"
    • IMPORTANT: Copy the token immediately - it's only shown once!

Add to Claude Code

bash
claude mcp add mcp-cloudflare-crunchtools \    --env CLOUDFLARE_API_TOKEN=your_token_here \    -- uvx mcp-cloudflare-crunchtools

Or for the container version:

bash
claude mcp add mcp-cloudflare-crunchtools \    --env CLOUDFLARE_API_TOKEN=your_token_here \    -- podman run -i --rm -e CLOUDFLARE_API_TOKEN quay.io/crunchtools/mcp-cloudflare

Permission Sets by Use Case

Read-Only (viewing only)
ResourcePermissionAccess
ZoneZoneRead
ZoneDNSRead
DNS Management Only
ResourcePermissionAccess
ZoneZoneRead
ZoneDNSEdit
Full Management (all features)
ResourcePermissionAccess
ZoneZoneRead
ZoneDNSEdit
ZonePage RulesEdit
ZoneTransform RulesEdit
ZoneCache PurgePurge

Usage Examples

List Your Zones

User: List my Cloudflare zonesAssistant: [calls list_zones]

Create a DNS Record

User: Create an A record for www.example.com pointing to 192.168.1.1Assistant: [calls create_dns_record with type=A, name=www, content=192.168.1.1]

Add Security Headers

User: Add X-Content-Type-Options: nosniff to all responses for zone abc123...Assistant: [calls set_response_header_rules with appropriate rule]

Purge Cache

User: Purge the cache for https://example.com/styles.cssAssistant: [calls purge_cache with files=["https://example.com/styles.css"]]

Security

This server was designed with security as a primary concern. See SECURITY.md for:

  • Threat model and attack vectors
  • Defense in depth architecture
  • Token handling best practices
  • Input validation rules
  • Audit logging

Key Security Features

  1. Token Protection

    • Stored as SecretStr (never accidentally logged)
    • Environment variable only (never in files or args)
    • Sanitized from all error messages
  2. Input Validation

    • Pydantic models for all inputs
    • Allowlist for record types, actions
    • Strict format validation for IDs
  3. API Hardening

    • Hardcoded API base URL (prevents SSRF)
    • TLS certificate validation
    • Request timeouts
    • Response size limits
  4. Automated CVE Scanning

    • GitHub Actions scan dependencies weekly
    • Automatic PRs for security updates
    • Dependabot alerts enabled

Development

Setup

bash
git clone https://github.com/crunchtools/mcp-cloudflare.gitcd mcp-cloudflareuv sync

Run Tests

bash
uv run pytest

Lint and Type Check

bash
uv run ruff check src testsuv run mypy src

Build Container

bash
podman build -t mcp-cloudflare .

License

AGPL-3.0-or-later

Contributing

Contributions welcome! Please read SECURITY.md before submitting security-related changes.

Links

來源:README.md,提交 8ff53ac

工具

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

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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

其他 Cloudflare 整合