Artifex MCP

🚀 Artifex MCP

An MCP server for AI image generation supporting multiple providers, offering diverse features for image creation and editing.

🚀 Quick Start

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

⚠️ Important Note

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.

✨ 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

💻 Usage Examples

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

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.

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

auth_status

Check authentication status for a provider.

auth_login

Get instructions for authenticating with a provider.

auth_logout

Delete stored credentials for a provider.

quota_status

Check rate limit and quota status for a provider.

🔧 Technical Details

Authentication

Antigravity (Default)

npx artifex-mcp --login

This will:

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

OpenAI

Set the OPENAI_API_KEY environment variable:

export OPENAI_API_KEY=sk-...

Provider Capabilities

File Locations

📚 Documentation

Troubleshooting

"Not authenticated" error (Antigravity)

npx artifex-mcp --login

"OpenAI API key not found" error

Set the environment variable:

export OPENAI_API_KEY=sk-...

Rate limit exceeded

Wait for the time indicated in the error message. Rate limits are enforced per-account.

Unsupported feature error

Some features are only available on specific providers. For example:

• session_id only works with Antigravity.
• input_image (editing) only works with Antigravity.
• count > 1 only works with Antigravity.

📄 License

MIT