Grok Image MCP

English | 中文

---

<a id="english"></a>

An MCP (Model Context Protocol) server for image generation and editing using the Grok image model from xAI.

> Note: This package was previously published as grok2-image-mcp-server. That package is now deprecated — please use grok-image-mcp instead.

Features

- Image Generation — Generate images from text prompts with configurable aspect ratio, resolution, and batch count
- Image Editing — Edit existing images with natural language instructions, supporting 1–3 source images
- Local File Support — Provide local image paths for editing; the server reads and encodes them automatically
- Image Proxy — Optional proxy domain for imgen.x.ai to handle network restrictions
- HTTP Proxy — Optional network proxy for API requests

Installation

Using npx (recommended)

{
  "mcpServers": {
    "grok_image": {
      "command": "npx",
      "args": ["grok-image-mcp"],
      "env": {
        "XAIAPI_KEY": "your-xai-api-key"
      }
    }
  }
}

Tools

generate_image

Generate images from text prompts.

| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | ✅ | Text description of the image to generate |
| n | number | | Number of images (1–10, default 1) |
| aspect_ratio | string | | Aspect ratio (1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, auto, etc.) |
| resolution | string | | Resolution (1k or 2k, default 1k) |

edit_image

Edit existing images using a text prompt.

| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | ✅ | Text description of the desired edits |
| image_urls | string[] | ✅ | 1–3 source images: URLs, base64 data URIs, or local file paths |
| n | number | | Number of output images (1–10, default 1) |
| aspect_ratio | string | | Override output aspect ratio (default: follows first input image) |
| resolution | string | | Resolution (1k or 2k, default 1k) |

Environment Variables

| Variable | Required | Description |
|---|---|---|
| XAIAPI_KEY | ✅ | xAI API key |
| XAIAPI_BASE_URL | | API base URL (default: https://api.x.ai/v1). Use a proxy if the API is inaccessible |
| IMAGE_PROXY_DOMAIN | | Proxy domain to replace imgen.x.ai in returned image URLs |
| HTTP_PROXY | | HTTP/HTTPS proxy for API requests (e.g. http://127.0.0.1:7890) |

Proxy Examples

API proxy:

XAIAPI_BASE_URL=https://api-proxy.me/xai/v1

Image proxy:

IMAGE_PROXY_DOMAIN=https://image.proxy.workers.dev

Network proxy:

HTTP_PROXY=http://127.0.0.1:7890

Using Cloudflare Workers to Proxy Image URLs

If image URLs from imgen.x.ai are inaccessible, deploy a Cloudflare Worker as a reverse proxy and set IMAGE_PROXY_DOMAIN to your custom domain:

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})
const TARGET_DOMAIN = 'imgen.x.ai'
async function handleRequest(request) {

  const url = new URL(request.url)

  const targetUrl = https://${TARGET_DOMAIN}${url.pathname}${url.search}
const init = {

    method: request.method,

    headers: request.headers,

    body: request.method === 'GET' || request.method === 'HEAD' ? undefined : request.body,

    redirect: 'follow'

  }
const response = await fetch(targetUrl, init)
const newHeaders = new Headers(response.headers)

  newHeaders.set('Access-Control-Allow-Origin', '')

return new Response(response.body, {

    status: response.status,

    statusText: response.statusText,

    headers: newHeaders

  })

}

{
  "mcpServers": {
    "grok_image": {
      "command": "npx",
      "args": ["grok-image-mcp"],
      "env": {
        "XAIAPI_KEY": "你的 xAI API 密钥"
      }
    }
  }
}

XAIAPI_BASE_URL=https://api-proxy.me/xai/v1

IMAGE_PROXY_DOMAIN=https://image.proxy.workers.dev

HTTP_PROXY=http://127.0.0.1:7890

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})
const TARGET_DOMAIN = 'imgen.x.ai'
async function handleRequest(request) {

  const url = new URL(request.url)

  const targetUrl = https://${TARGET_DOMAIN}${url.pathname}${url.search}
const init = {

    method: request.method,

    headers: request.headers,

    body: request.method === 'GET' || request.method === 'HEAD' ? undefined : request.body,

    redirect: 'follow'

  }
const response = await fetch(targetUrl, init)
const newHeaders = new Headers(response.headers)

  newHeaders.set('Access-Control-Allow-Origin', '')
return new Response(response.body, {

    status: response.status,

    statusText: response.statusText,

    headers: newHeaders

  })

}

许可证

MIT