AI导哈

Cloudflare 运维 MCP 服务

mcp-cloudflare 是一个将 Cloudflare 操作封装为 Python 库、LangChain 工具和 MCP 服务器的服务，覆盖 Zones、DNS、Tunnels、Cache、Accounts 等资源管理，适用于通过 Claude Code 或 LangChain 代理对 Cloudflare 进行自动化运维。

  • by lyzetam
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 lyzetam/mcp-cloudflare

使用说明

mcp-cloudflare

Cloudflare operations as a Python library, LangChain tools, and MCP server.

Features

  • 19 LangChain tools for use with LangChain/LangGraph agents
  • 19 MCP tools for use with Claude Code and other MCP clients
  • Modular operations layer usable as a standalone Python library
  • Covers Zones, DNS, Tunnels, Cache, and Accounts

MCP Tools

Category Tools
Status cloudflare_status
Zones zone_list, zone_get, zone_settings
DNS dns_list, dns_create, dns_update, dns_delete
Tunnels tunnel_list, tunnel_get, tunnel_create, tunnel_delete, tunnel_configurations, tunnel_update_config
Cache cache_purge_all, cache_purge_urls, cache_purge_tags, cache_purge_prefixes
Accounts account_list

LangChain Tools

Category Tools
Status cf_status
Zones cf_zone_list, cf_zone_get, cf_zone_settings
DNS cf_dns_list, cf_dns_create, cf_dns_update, cf_dns_delete
Tunnels cf_tunnel_list, cf_tunnel_get, cf_tunnel_create, cf_tunnel_delete, cf_tunnel_configurations, cf_tunnel_update_config
Cache cf_cache_purge_all, cf_cache_purge_urls, cf_cache_purge_tags, cf_cache_purge_prefixes
Accounts cf_account_list

Installation

# Core library only (httpx)
pip install .

# With MCP server support
pip install ".[mcp]"

# With LangChain tools
pip install ".[langchain]"

# Everything
pip install ".[all]"

Configuration

All settings are read from environment variables with the CLOUDFLARE_ prefix, or from a .env file.

Authentication Methods

The server supports two authentication methods (Global API Key is preferred):

Option 1: Global API Key (Full Permissions - Recommended)

Variable Description Default
CLOUDFLARE_EMAIL Cloudflare account email ""
CLOUDFLARE_API_KEY Cloudflare Global API Key ""

Option 2: Scoped API Token (Limited Permissions)

Variable Description Default
CLOUDFLARE_API_TOKEN Cloudflare API token ""

Note: If both methods are configured, Global API Key takes priority. For full functionality including zone creation, use the Global API Key method.

Quick Start

As a Python library

from mcp_cloudflare.client import CloudflareClient
from mcp_cloudflare.operations import dns, zones

client = CloudflareClient()
zone_list = zones.list_zones(client)
records = dns.list_records(client, zone_id="...")

As LangChain tools

from mcp_cloudflare.langchain_tools import TOOLS

# Use with a LangChain agent
agent = create_react_agent(llm, TOOLS)

As an MCP server

mcp-cloudflare

.env example

Using Global API Key (recommended for full access):

CLOUDFLARE_EMAIL=your-email@example.com
CLOUDFLARE_API_KEY=your-global-api-key

Using Scoped API Token:

CLOUDFLARE_API_TOKEN=your-api-token

Using both (Global API Key will be preferred):

CLOUDFLARE_EMAIL=your-email@example.com
CLOUDFLARE_API_KEY=your-global-api-key
CLOUDFLARE_API_TOKEN=your-api-token

License

MIT

相关 MCP