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

| Variable | Required | Default | Description | | ----------------- | -------- | ------------- | ------------------------------------------------- | | GEMINI_API_KEY | Option 1 | — | AI Studio API key (takes priority over Vertex AI) | | VERTEX_PROJECT | Option 2 | — | Google Cloud project ID (Vertex AI) | | VERTEX_LOCATION | No | us-central1 | Vertex AI location |

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:

| Parameter | Type | Required | Default | Description | | -------------- | ------ | -------- | ------------------------------ | ------------------------------------------------------------------------------------- | | prompt | string | Yes | — | Text prompt for image generation (English recommended) | | aspect_ratio | enum | No | "1:1" | Aspect ratio: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | | output_path | string | Yes | — | File path to save the generated image (.png) | | model | string | No | "gemini-3-pro-image-preview" | Gemini model name (e.g. gemini-2.5-flash-image) |

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:

| Script | Check | Tool | | ---------------- | ------------------------------ | -------------------------- | | typecheck | Type checking (strict) | tsc --noEmit | | lint | Linter + cyclomatic complexity | ESLint + typescript-eslint | | format:check | Code formatting | Prettier | | test:coverage | Tests + coverage report | Vitest + V8 | | audit | Known CVE scan | npm audit | | audit:lockfile | Lockfile integrity | lockfile-lint | | sast | Security static analysis | Semgrep |

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

License

MIT

organon-create-image