Cloudflare MCP

🚀 Cloudflare MCP Server

A modern Model-Context-Protocol (MCP) server that exposes Cloudflare DNS, security, redirects, and zone-settings functionality as structured tools that any compliant AI client (e.g., Claude Desktop) can invoke.

🚀 Quick Start

# 1. Clone & install
npm install

# 2. Configure credentials
cp config/.env.example .env
$EDITOR .env          # put your CLOUDFLARE_API_TOKEN

# 3. Build & run the server (stdio)
npm run build
node dist/index.js    # Claude Desktop will auto-detect

⚠️ Important Note

Need a sandbox? Cloudflare Workers Free Plan lets you create test zones.

✨ Features

• Rich Tool Catalog – 16 read & write operations covering DNS records, WAF rules, page-rule redirects, cache purge, zone settings and more.
• Plug-and-Play with Claude Desktop – ships with STDIO transport so Claude immediately lists & calls tools; no extra adaptor required.
• Type-Safe – written in TypeScript and powered by @modelcontextprotocol/sdk, with zod schemas for every tool’s params & return value.
• Non-destructive by Default – destructive certificate-ordering functions are disabled out-of-the-box to prevent accidental cost.
• Script Library & Tests – one-shot scripts for manual ops plus Jest integration/unit tests.

📦 Installation

# 1. Clone & install
npm install

# 2. Configure credentials
cp config/.env.example .env
$EDITOR .env          # put your CLOUDFLARE_API_TOKEN

# 3. Build & run the server (stdio)
npm run build
node dist/index.js    # Claude Desktop will auto-detect

💻 Usage Examples

Basic Usage

# 1. Clone & install
npm install

# 2. Configure credentials
cp config/.env.example .env
$EDITOR .env          # put your CLOUDFLARE_API_TOKEN

# 3. Build & run the server (stdio)
npm run build
node dist/index.js    # Claude Desktop will auto-detect

Advanced Usage

# Watch-mode compile
npm run dev

# Run the full test suite
npm test

# Lint
npm run lint

📚 Documentation

🛠️ Tool Catalog

* Destructive operations – use with care.

SSL cert ordering/upload functions are intentionally not registered. Enable them by removing the filter in src/index.ts if required.

🧑‍💻 Development

# Watch-mode compile
npm run dev

# Run the full test suite
npm test

# Lint
npm run lint

Handy demo scripts live under scripts/ (e.g., scripts/list-dns-demo.ts). All accept a --zone flag.

🏗️ Architecture

• src/index.ts – entrypoint; merges tool maps and registers them with McpServer.
• src/tools/ – individual tool modules, each exporting { tools, description }.
• src/cloudflare-client.ts – thin wrapper around axios + CF API base URL.
• tests/ – Jest tests (unit + integration).

The server communicates over STDIO using JSON-RPC 2.0 as defined by the MCP SDK. See .

🔧 Technical Details

The server is written in TypeScript and powered by @modelcontextprotocol/sdk. It uses zod schemas for every tool’s params & return value to ensure type safety. The server communicates over STDIO using JSON-RPC 2.0 as defined by the MCP SDK.

🤝 Contributing

PRs & issues are welcome! Please read for coding conventions and style guidelines.

1. Fork → feature branch → PR.
2. Ensure npm test passes.
3. Describe the tool behaviour or bug clearly.

📄 License

MIT © 2025 Jeff Golden

Made with Windsurf