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.

edit_image

Edit existing images using a text prompt.

Environment Variables

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
  })
}

License

MIT

---

<a id="中文"></a>

基于 MCP 协议的 Grok 图像生成与编辑服务。

注意: 此包的前身是 grok2-image-mcp-server，该包已弃用，请使用 grok-image-mcp。

功能

• 图像生成 — 通过文本提示生成图像，可配置宽高比、分辨率和批量数量
• 图像编辑 — 使用自然语言编辑现有图像，支持 1–3 张源图
• 本地文件支持 — 可提供本地图片路径进行编辑，服务端自动读取并编码
• 图片代理 — 可选代理域名替换 imgen.x.ai，解决网络访问问题
• 网络代理 — 支持 HTTP/HTTPS 代理

安装

使用 npx（推荐）

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

工具

generate_image

通过文本提示生成图像。

edit_image

使用文本提示编辑现有图像。

环境变量

代理示例

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

使用 Cloudflare Workers 代理图片 URL

如果 imgen.x.ai 的图片无法访问，可部署 Cloudflare Worker 反向代理，然后将 IMAGE_PROXY_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
  })
}

许可证

MIT