MCP Server Cloudflare — Workers, KV, R2, DNS & Cache

This Model Context Protocol (MCP) server (io.github.ofershap/cloudflare) provides IDE-based management for Cloudflare Workers, KV, R2, Pages, DNS, and cache. It is part of the MCP ecosystem and targets developer workflows related to Cloudflare resources.

🛠️ Key Features

Manage Cloudflare Workers
Manage Cloudflare KV
Manage Cloudflare R2
Manage Cloudflare Pages
Manage Cloudflare DNS
Manage Cloudflare cache

🚀 Use Cases

Configure and maintain Cloudflare components from within an IDE
Manage data storage (KV, R2) alongside application runtime (Workers, Pages)
Handle DNS and cache-related tasks during development

⚡ Developer Benefits

Align Cloudflare operations with Model Context Protocol (MCP) tooling
Uses TypeScript in the project context (as indicated by topics)

⚠️ Limitations

Capabilities are limited to the Cloudflare areas listed: Workers, KV, R2, Pages, DNS, and cache.

Tags / Topics

cloudflare, dns, kv, mcp, mcp-server, model-context-protocol, r2, typescript, workers

MCP Server Cloudflare — Workers, KV, R2, DNS & Cache for AI Assistants

npm version npm downloads Agent Plugins

An MCP server that lets your AI assistant manage Cloudflare Workers, KV, R2, DNS, and cache purging. Vercel, Railway, and Netlify all have MCP servers — now Cloudflare does too.

code

You: "List my Workers and purge cache for example.com"
AI:  Found 3 Workers: api-gateway, auth-worker, image-resizer
     ✅ Cache purged for https://example.com

Works with Claude Desktop, Cursor, and VS Code Copilot.

MCP server Cloudflare demo — listing Workers and purging cache from Claude Desktop

Tools

Tool	What it does
`cf_zones`	List your Cloudflare zones (domains)
`cf_dns_list`	List DNS records for a zone
`cf_dns_create`	Create a DNS record
`cf_dns_delete`	Delete a DNS record
`cf_workers_list`	List Workers scripts
`cf_worker_delete`	Delete a Workers script
`cf_kv_namespaces`	List KV namespaces
`cf_kv_keys`	List keys in a KV namespace
`cf_kv_get`	Get a value from KV
`cf_kv_put`	Write a value to KV
`cf_kv_delete`	Delete a KV key
`cf_r2_buckets`	List R2 storage buckets
`cf_cache_purge`	Purge cache (all or specific URLs)

Quick Start

With Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": ["-y", "mcp-server-cloudflare-dns"],
      "env": {
        "CLOUDFLARE_API_TOKEN": "your_api_token",
        "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}

With Cursor

Add to your .cursor/mcp.json:

json

{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": ["-y", "mcp-server-cloudflare-dns"],
      "env": {
        "CLOUDFLARE_API_TOKEN": "your_api_token",
        "CLOUDFLARE_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}

Authentication

Go to Cloudflare Dashboard > API Tokens
Create a token with the permissions you need:
- Zone:Read — for listing zones and DNS
- Zone:Edit — for creating/deleting DNS records
- Workers Scripts:Edit — for managing Workers
- Workers KV Storage:Edit — for KV operations
- Zone:Cache Purge — for cache purging
Set CLOUDFLARE_API_TOKEN environment variable
Set CLOUDFLARE_ACCOUNT_ID for Workers, KV, and R2 operations

Examples

Ask your AI assistant:

"List my Cloudflare zones"
"Show DNS records for zone xyz"
"Create an A record pointing to 1.2.3.4"
"List my Workers"
"Show KV keys in namespace abc"
"Purge the cache for https://example.com/page"
"List my R2 buckets"

Agent Plugins

This repo is an Agent Plugins 1.0.0 package: plugin.json, portable mcp.json, and skills/ ship together with the MCP server.

For Cursor, clone the repo and copy or symlink it to ~/.cursor/plugins/local/mcp-server-cloudflare, then reload the window. Skills and MCP show up under Customize > Plugins.

Agent Plugins v1 does not ship OAuth. Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID in your MCP client env (see Quick Start). One-click install is not offered because credentials stay in env.

Install and run via npm package mcp-server-cloudflare-dns (not the unrelated mcp-server-cloudflare stub on npm).

FAQ

What npm package do I install?

Use npx -y mcp-server-cloudflare-dns. The repo is named mcp-server-cloudflare on GitHub; npm publishes as mcp-server-cloudflare-dns.

Which env vars are required?

CLOUDFLARE_API_TOKEN for all API calls. CLOUDFLARE_ACCOUNT_ID for Workers, KV, and R2 tools.

Can I install it as an Agent Plugin in Cursor?

Yes, via ~/.cursor/plugins/local/mcp-server-cloudflare. Configure the same env vars in Cursor MCP settings.

What can this MCP manage?

Zones and DNS, Workers scripts, KV namespaces, R2 bucket listing, and cache purge for a zone.

Why no one-click Cursor button?

API token and account id cannot be embedded in a portable install link. Use the JSON under Quick Start.

Development

bash

npm install
npm test
npm run build

Author

_{README built with README Builder}

io.github.ofershap/cloudflare