English | 简体中文

This is an extension for the Gemini CLI that integrates Cloudflare's Model Context Protocol (MCP) servers. It allows you to interact with various Cloudflare services (such as Workers, R2, DNS, Logs, etc.) using natural language.

This project uses mcp-remote to connect to Cloudflare-hosted remote MCP endpoints.

cloudflare-mcp/
├── commands/
│   └── cloudflare/
│       ├── dev.toml      # Development commands (Workers, Builds, Bindings)
│       ├── ops.toml      # Operations commands (Observability, Logs, Audit)
│       └── info.toml     # Information commands (Docs, Radar, GraphQL)
├── GEMINI.md             # AI assistant system prompts and context configuration
├── gemini-extension.json # Core extension configuration and MCP server registry
├── README.md             # English documentation
└── README_zh.md          # Chinese documentation

• Gemini CLI: Ensure the Gemini CLI environment is installed and configured.
• Node.js & NPM: This extension relies on npx to run mcp-remote. Ensure Node.js is in your system path.
• Cloudflare Account: A valid Cloudflare account is required to obtain API credentials.

Setting the CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID is a critical step to ensure the Gemini CLI can securely authenticate with Cloudflare via the MCP protocol. Without these credentials, the remote MCP servers will reject connection requests.

You need to obtain an API Token from the Cloudflare Dashboard. It is recommended to create a Token with Read/Write permissions for the services you intend to use (e.g., Workers, DNS, Logs).

Add the following to your terminal configuration file (e.g., .bashrc, .zshrc, or PowerShell profile), or export them in the current session before running the Gemini CLI:

• macOS / Linux:

  export CLOUDFLARE_API_TOKEN="your_api_token"
  export CLOUDFLARE_ACCOUNT_ID="your_account_id"

• Windows (PowerShell):

  $env:CLOUDFLARE_API_TOKEN="your_api_token"
  $env:CLOUDFLARE_ACCOUNT_ID="your_account_id"

• Navigate to the project root directory in your terminal and run the following command to link the extension to the Gemini CLI:

  gemini extensions link .

  Once linked, restart the Gemini CLI for changes to take effect.

• Or install the extension using the following command:

  gemini extensions install https://github.com/ZhanZiyuan/cloudflare-mcp

This extension registers commands under the cloudflare group. You invoke them using the / prefix followed by group:command.

• Development Tasks (Workers, Builds): invokes commands defined in commands/cloudflare/dev.toml:

  /cloudflare:dev "List my recent Worker build statuses"
  

• Operations & Monitoring (Logs, Analytics): invokes commands defined in commands/cloudflare/ops.toml:

  /cloudflare:ops "Check for DNS resolution errors in the last hour"
  

• Information Retrieval (Docs, Radar): invokes commands defined in commands/cloudflare/info.toml:

  /cloudflare:info "How do I use KV storage in Cloudflare Workers?"
  

The AI will automatically detect your language preference and respond in English or Chinese based on the configuration in GEMINI.md.

Based on the Gemini CLI Extensions Guide and Cloudflare Agents docs.