MCP 服务器

Artifex MCP

Enables AI image generation via Antigravity (Google Gemini) and OpenAI DALL-E 3, supporting text-to-image, image editing, multiple outputs, and character consistency.

README

<h1 align="center">Artifex MCP</h1>

⚠️ UNOFFICIAL TOOL: This is an independent, community-developed MCP server. It is not affiliated with, endorsed by, or supported by Google or OpenAI. Use at your own risk.

MCP (Model Context Protocol) server for AI image generation supporting multiple providers:

Antigravity (default) - Google's Gemini 3 Pro Image model
OpenAI - DALL-E 3

Features

Multi-Provider Support: Switch between Antigravity and OpenAI with a simple parameter
Text-to-Image: Generate images from text descriptions
Image Editing: Modify existing images with text instructions (Antigravity only)
Multiple Outputs: Generate up to 4 image variations per request (Antigravity only)
Character Consistency: Session-based generation for consistent characters (Antigravity only)
Multiple Aspect Ratios: 1:1, 16:9, 9:16, 3:4, 4:3, and more

Installation

Run directly with npx (recommended):

npx artifex-mcp

Or install globally:

npm install -g artifex-mcp

Authentication

Antigravity (Default)

npx artifex-mcp --login

This will:

Open your browser for Google OAuth
Store credentials securely in ~/.config/artifex-mcp/auth.json

OpenAI

Set the OPENAI_API_KEY environment variable:

export OPENAI_API_KEY=sk-...

Usage

As an MCP Server

Add to your MCP client configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "artifex": {
      "command": "npx",
      "args": ["artifex-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

OpenCode:

{
    "mcp": {
        "artifex": {
            "type": "local",
            "command": ["npx", "artifex-mcp"],
            "enabled": true,
            "env": {
                "OPENAI_API_KEY": "sk-..."
            }
        }
    }
}

Environment Variables

Variable	Description	Default
`DEFAULT_IMAGE_PROVIDER`	Default provider to use	`antigravity`
`DEFAULT_IMAGE_MODEL`	Default model for the provider	`gemini-3-pro-image`
`OPENAI_API_KEY`	API key for OpenAI provider	-

Provider Selection

Use the model parameter with provider:model format:

# Use Antigravity (default)
generate_image({ prompt: "a cat" })

# Use OpenAI DALL-E 3
generate_image({ prompt: "a cat", model: "openai:dall-e-3" })

# Use a specific Antigravity model
generate_image({ prompt: "a cat", model: "antigravity:gemini-3-pro-image" })

Available Tools

`generate_image`

Generate images from text prompts.

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Image description or editing instruction
`model`	string	No	env default	Provider and model in `provider:model` format
`aspect_ratio`	enum	No	"1:1"	1:1, 16:9, 9:16, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 21:9
`output_path`	string	No	cwd	Directory to save images
`file_name`	string	No	auto	Custom filename
`input_image`	string	No	-	Path to image for editing (Antigravity only)
`count`	number	No	1	Number of images 1-4 (Antigravity only)
`session_id`	string	No	-	For character consistency (Antigravity only)

Examples:

# Default provider (Antigravity)
Generate a cyberpunk cityscape at night

# Using OpenAI
Generate a cyberpunk cityscape at night, model: openai:dall-e-3

# Multiple images (Antigravity only)
Generate 4 variations of a majestic dragon, aspect ratio 16:9

# Character consistency (Antigravity only)
Create a hero named Luna, session_id: luna