Cloudflare MCP

🚀 Cloudflare MCP Server

このModern Model-Context-Protocol (MCP)サーバーは、CloudflareのDNS、セキュリティ、リダイレクト、ゾーン設定機能を構造化されたツールとして公開しています。これらのツールは、Claude DesktopなどのMCPに準拠したAIクライアントから呼び出すことができます。

✨ 主な機能

• 豊富なツールカタログ – DNSレコード、WAFルール、ページルールリダイレクト、キャッシュ削除、ゾーン設定など、16の読み取りと書き込み操作が用意されています。
• Claude Desktopとの即座の連携 – STDIOトランスポートを搭載しているため、Claudeがすぐにツールをリストアップして呼び出せます。追加のアダプターは不要です。
• 型安全 – TypeScriptで記述され、@modelcontextprotocol/sdkを使用しており、各ツールのパラメータと戻り値にはzodスキーマが用意されています。
• デフォルトで非破壊的 – 破壊的な証明書発行機能はデフォルトで無効になっており、誤ったコスト発生を防ぎます。
• スクリプトライブラリとテスト – 手動操作のためのワンショットスクリプトと、Jestによる統合/単体テストが用意されています。

🚀 クイックスタート

# 1. クローンとインストール
npm install

# 2. 資格情報の設定
cp config/.env.example .env
$EDITOR .env          # あなたのCLOUDFLARE_API_TOKENを入力

# 3. サーバーのビルドと実行 (stdio)
npm run build
node dist/index.js    # Claude Desktopが自動検出します

サンドボックスが必要ですか？ Cloudflare Workers Free Planを使ってテストゾーンを作成できます。

🛠️ ツールカタログ

* 破壊的な操作です – 注意して使用してください。

SSL証明書の発行/アップロード機能は意図的に登録されていません。必要に応じてsrc/index.tsのフィルターを削除することで有効にできます。

🧑‍💻 開発

# ウォッチモードでコンパイル
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によるテスト（単体 + 統合）。

サーバーはSTDIOを介して、MCP SDKで定義されたJSON-RPC 2.0により通信します。詳細はを参照してください。

🤝 コントリビューション

PRとイシューは大歓迎です！ コーディング規約とスタイルガイドラインについては、を読んでください。

1. フォーク → フィーチャーブランチ → PR。
2. npm testが通ることを確認してください。
3. ツールの動作やバグを明確に説明してください。

📜 ライセンス

MIT © 2025 Jeff Golden

Made with Windsurf