Cloudflare MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with the Cloudflare API. Built with Python and managed with uv for blazing-fast dependency management.

Features

🌐 Zone Management

• List all zones in your account

• Get detailed zone information

• Filter zones by name and status

🔧 DNS Management

• List DNS records with filtering

• Create new DNS records (A, AAAA, CNAME, TXT, MX, etc.)

• Update existing records

• Delete records

• Full support for proxied records and TTL configuration

💾 Workers KV Storage

• List KV namespaces

• Read values from KV

• Write key-value pairs with optional TTL

• Delete keys

• List keys with prefix filtering

• Support for metadata

⚡ Cache & Performance

• Purge cache (entire zone or specific files/tags/hosts)

• Get zone analytics (requests, bandwidth, threats)

Installation

Prerequisites

• Python 3.10 or higher

• uv installed

• A Cloudflare account with an API token

Quick Start with uv

1. Clone or create the project:

2. Install with uv:

Or install from the directory:

Alternative: Using pip

Configuration

Getting Your Cloudflare Credentials

1. API Token (Required):

   • Go to Cloudflare Dashboard

   • Click "Create Token"

   • Use "Edit zone DNS" template or create a custom token with the permissions you need

   • Copy the token

2. Account ID (Optional, but required for KV operations):

   • Go to your Cloudflare dashboard

   • Select any website

   • Scroll down on the Overview page to find your Account ID

Environment Variables

Set the following environment variables:

Or create a .env file (see .env.example).

Claude Desktop Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Using uv (recommended):

Using Python directly:

Available Tools

The server provides 13 powerful tools for managing Cloudflare resources:

Zone Operations

• list_zones - List all zones (domains) with optional filtering

• get_zone - Get detailed information about a specific zone

DNS Operations

• list_dns_records - List DNS records with filtering

• create_dns_record - Create new DNS records

• update_dns_record - Update existing DNS records

• delete_dns_record - Delete DNS records

Cache Operations

• purge_cache - Purge cached content (entire zone or specific files/tags/hosts)

Workers KV Operations

• list_kv_namespaces - List all KV namespaces

• read_kv_value - Read a value from KV storage

• write_kv_value - Write a key-value pair to KV

• delete_kv_value - Delete a key from KV

• list_kv_keys - List all keys in a namespace

Analytics

• get_zone_analytics - Get analytics data for a zone

For detailed documentation on each tool, see EXAMPLES.md.

Development

Using uv for Development

Project Structure

Usage Examples

Example 1: List Your Zones

Ask Claude:

"Show me all my Cloudflare zones"

Example 2: Create a DNS Record

Ask Claude:

"Create an A record for api.example.com pointing to 192.0.2.100 with proxy enabled"

Example 3: Purge Cache

Ask Claude:

"Clear the cache for https://example.com/style.css"

For more examples, see EXAMPLES.md.

API Permissions

Your Cloudflare API token needs appropriate permissions based on what operations you want to perform:

Minimum Permissions:

• Zone - Zone - Read (for listing zones)

• Zone - DNS - Edit (for DNS operations)

Additional Permissions for Advanced Features:

• Account - Workers KV Storage - Edit (for KV operations)

• Zone - Cache Purge - Purge (for cache operations)

• Zone - Analytics - Read (for analytics)

Troubleshooting

Common Issues

1. "CLOUDFLARE_API_TOKEN environment variable is required"

   • Make sure you've set the environment variable

   • Check your Claude Desktop config has the correct token in the env section

2. "Account ID is required"

   • Set CLOUDFLARE_ACCOUNT_ID environment variable for KV operations

   • Or pass account_id parameter directly in tool calls

3. uv command not found

   • Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh

   • Or use pip as an alternative

4. Module not found errors

   • Make sure you installed the package: uv pip install -e .

   • Check you're in the right directory

Why uv?

This project uses uv because it's:

• ⚡ 10-100x faster than pip

• 🔒 More reliable with better dependency resolution

• 🎯 Simpler - one tool for everything

• 🐍 Modern - built in Rust, designed for Python

Security Notes

• Never commit your API token to version control

• Store tokens securely using environment variables

• Use API tokens instead of API keys (they're more secure and can be scoped)

• Regularly rotate your API tokens

• Use the minimum required permissions for your token

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE file for details.

Links

• Cloudflare API Documentation

• Model Context Protocol

• uv - Python Package Manager

• Claude Desktop

Support

For issues related to:

• This MCP server: Open an issue on GitHub

• Cloudflare API: Check Cloudflare Developer Docs

• MCP Protocol: Check MCP Documentation

• uv: Check uv Documentation