opencode-cloudflare-image-mcp

An MCP (Model Context Protocol) server that gives any MCP-capable AI model (Claude Desktop, opencode, etc.) the ability to generate images from text prompts and describe images in text, using Cloudflare Workers AI models.

Features

• generate_image — Generate images from text prompts using Cloudflare text-to-image models (FLUX.1 Schnell, SDXL, DreamShaper, and more).

• describe_image — Generate text descriptions of images using Cloudflare image-to-text models (LLaVA, Moondream, uForm).

• list_models — Discover all supported models with aliases and defaults.

• Generated images are saved to disk; the file path is returned to the model.

• Image-to-text supports both local file paths and HTTP(S) URLs as input.

Related MCP server: nanobanana-mcp-server

Install via OpenCode Agent

Paste this to your opencode agent to install and configure:

Install the opencode-cloudflare-image-mcp MCP server globally, then add it to my opencode.json config at ~/.config/opencode/opencode.json as a local MCP server with:
- type: local
- command: ["node", "E:/Image-MCP/dist/index.js"] (or your install path)
- environment with CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_API_TOKEN

Or manually:

npm install -g opencode-cloudflare-image-mcp

Then add to ~/.config/opencode/opencode.json:

{
  "mcp": {
    "cloudflare-image": {
      "type": "local",
      "command": ["node", "E:/Image-MCP/dist/index.js"],
      "environment": {
        "CLOUDFLARE_ACCOUNT_ID": "your-account-id",
        "CLOUDFLARE_API_TOKEN": "your-api-token"
      },
      "enabled": true
    }
  }
}

Note: Use "environment" not "env" for the env vars in opencode config.

Install (Manual)

npm install -g opencode-cloudflare-image-mcp

Or use directly with npx:

npx opencode-cloudflare-image-mcp

Configuration

Environment Variables

Getting a Cloudflare API Token

1. Go to the Cloudflare dashboard.

2. Navigate to My Profile → API Tokens.

3. Click Create Token.

4. Use the Workers AI template, or create a custom token with Workers AI:Read permission.

5. Copy the token and set it as CLOUDFLARE_API_TOKEN.

Your Cloudflare Account ID is visible on the dashboard overview page or any domain's overview page.

Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "cloudflare-image": {
      "command": "npx",
      "args": ["-y", "opencode-cloudflare-image-mcp"],
      "env": {
        "CLOUDFLARE_ACCOUNT_ID": "your-account-id",
        "CLOUDFLARE_API_TOKEN": "your-api-token"
      }
    }
  }
}

opencode / Generic stdio

{
  "mcp": {
    "cloudflare-image": {
      "type": "local",
      "command": ["npx", "-y", "opencode-cloudflare-image-mcp"],
      "env": {
        "CLOUDFLARE_ACCOUNT_ID": "your-account-id",
        "CLOUDFLARE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Usage

Once connected, the AI model can call these tools:

generate_image

Generate an image of a cyberpunk lizard in a neon-lit city

The model will call generate_image with the prompt. The image is saved to disk and the file path is returned.

describe_image

Describe the image at /path/to/image.png

Or with a URL:

What's in this image? https://example.com/photo.jpg

list_models

What image models are available?

Supported Models

Text-to-Image

Image-to-Text

Development

pnpm install
pnpm test
pnpm build

License

MIT