organon-create-image

MCP server for image generation using Gemini.

Features

• Text-to-image generation via Gemini (default: gemini-3-pro-image-preview)
• Multiple aspect ratio support (1:1, 16:9, 9:16, etc.)
• Returns generated images both as files and inline via MCP image content type
• Supports both AI Studio (API key) and Vertex AI (service account) backends

Prerequisites

• Node.js 18+
• One of the following:
• AI Studio: A Gemini API key from Google AI Studio
• Vertex AI: A Google Cloud project with Vertex AI API enabled + Application Default Credentials

Setup

npm install
npm run build

Configuration

Environment Variables

Note: Set either GEMINI_API_KEY or VERTEX_PROJECT. If both are set, GEMINI_API_KEY takes priority.

Claude Code MCP Registration

AI Studio (recommended for access to preview models):

{
  "mcpServers": {
    "create-image": {
      "command": "node",
      "args": ["/path/to/organon-create-image/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

Vertex AI:

{
  "mcpServers": {
    "create-image": {
      "command": "node",
      "args": ["/path/to/organon-create-image/dist/index.js"],
      "env": {
        "VERTEX_PROJECT": "your-gcp-project-id"
      }
    }
  }
}

Tools

generate_image

Generate an image from a text prompt.

Parameters:

Returns: Generated image saved to output_path, plus inline image via MCP image content type.

Quality Checks

Run all quality checks at once:

npm run check:all

This executes the following checks in sequence:

Note: Semgrep requires a separate installation via pip. See QUALITY.md for setup details.

License

MIT