Cloudflare MCP

🚀 雲flare MCP服務器

這是一個現代的模型 - 上下文 - 協議（MCP）服務器，它將Cloudflare的DNS、安全、重定向和區域設置功能以結構化的工具形式公開，任何兼容的AI客戶端（如Claude Desktop）都可以調用這些工具。

點擊此處

✨ 主要特性

• 豐富的工具目錄：涵蓋16種讀寫操作，包括DNS記錄、WAF規則、頁面規則重定向、緩存清除、區域設置等。
• 與Claude Desktop即插即用：配備標準輸入輸出（STDIO）傳輸，Claude可立即列出並調用工具，無需額外的適配器。
• 類型安全：使用TypeScript編寫，並由@modelcontextprotocol/sdk提供支持，每個工具的參數和返回值都有zod模式。
• 默認非破壞性：默認禁用具有破壞性的證書訂購功能，以防止意外產生費用。
• 腳本庫和測試：提供用於手動操作的一次性腳本，以及Jest集成/單元測試。

🚀 快速開始

# 1. 克隆並安裝
npm install

# 2. 配置憑證
cp config/.env.example .env
$EDITOR .env          # 填入你的CLOUDFLARE_API_TOKEN

# 3. 構建並運行服務器（標準輸入輸出）
npm run build
node dist/index.js    # Claude Desktop將自動檢測

需要沙盒環境？Cloudflare Workers免費計劃可讓你創建測試區域。

🛠️ 工具目錄

* 破壞性操作 - 請謹慎使用。

SSL證書訂購/上傳功能有意未註冊。如有需要，可通過刪除src/index.ts中的過濾器來啟用它們。

💻 使用示例

基礎用法

# 克隆並安裝依賴
npm install

# 配置憑證
cp config/.env.example .env
$EDITOR .env          # 填入你的CLOUDFLARE_API_TOKEN

# 構建並運行服務器
npm run build
node dist/index.js    # Claude Desktop將自動檢測

高級用法

# 開發模式下編譯
npm run dev

# 運行完整測試套件
npm test

# 代碼檢查
npm run lint

🧑‍💻 開發

# 監聽模式編譯
npm run dev

# 運行完整測試套件
npm test

# 代碼檢查
npm run lint

便捷的演示腳本位於scripts/目錄下（例如scripts/list-dns-demo.ts）。所有腳本都接受--zone標誌。

🔧 技術細節

架構

• src/index.ts：入口點；合併工具映射並將其註冊到McpServer。
• src/tools/：各個工具模塊，每個模塊導出{ tools, description }。
• src/cloudflare-client.ts：圍繞axios和CF API基本URL的輕量級包裝器。
• tests/：Jest測試（單元和集成測試）。

服務器通過標準輸入輸出使用JSON - RPC 2.0進行通信，具體定義見MCP SDK。詳情請參閱。

🤝 貢獻

歡迎提交拉取請求（PR）和提出問題！請閱讀瞭解編碼約定和風格指南。

1. 分叉倉庫 → 創建功能分支 → 提交PR。
2. 確保npm test測試通過。
3. 清晰描述工具行為或問題。

📄 許可證

本項目採用MIT許可證 © 2025 Jeff Golden

由Windsurf構建