Grok Image Generator MCP server

The Grok AI Image Generation MCP Server connects to xAI's image generation API, enabling you to create images from text prompts using the Grok-2-image model. This implementation includes support for generating multiple images and different response formats while providing convenient Docker integration.

Installation

Environment Setup

To use the MCP server, you need to set up the environment with your xAI API key:

export XAI_API_KEY=your-api-key

Docker Installation

For a containerized setup, you can use Docker:

1. Navigate to the project directory:

cd /path/to/ai-image-generator

2. Build the Docker image:

docker build -t grokart .

3. Run the container with your API key:

docker run -e XAI_API_KEY=your-api-key -p 8080:8080 grokart

Usage

Generating Images

The MCP server provides image generation capabilities through the generate_image tool. You can send prompts like:

• "Generate an image of a cat in a space suit"
• "Create a picture of a futuristic city at night"

Setting the API Key

If you didn't set the API key through environment variables during startup, you can set it at runtime using the set_api_key tool:

set_api_key your-xai-api-key

Advanced Configuration

Multiple Image Generation

The server supports generating up to 10 images in a single request. When using the API directly, you can specify the number of images you want to generate.

Response Formats

You can receive image data in two formats:

• URL format: Returns web addresses where the generated images can be accessed
• Base64 JSON: Returns the image data encoded directly in the response

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "grok-image-generator" '{"command":"npx","args":["-y","grok-mcp"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "grok-image-generator": {
            "command": "npx",
            "args": [
                "-y",
                "grok-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "grok-image-generator": {
            "command": "npx",
            "args": [
                "-y",
                "grok-mcp"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect