Skip to main content
Glama
fl0w1nd

Grok Image MCP

by fl0w1nd
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Grok Image MCP

English | 中文

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

License

MIT

基于 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

通过文本提示生成图像。

参数

类型

必填

说明

prompt

string

✅

描述要生成的图像内容

n

number

生成数量（1–10，默认 1）

aspect_ratio

string

宽高比（1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2、auto 等）

resolution

string

分辨率（1k 或 2k，默认 1k）

edit_image

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

参数

类型

必填

说明

prompt

string

✅

描述所需的编辑内容

image_urls

string[]

✅

1–3 张源图：URL、base64 data URI 或本地文件路径

n

number

输出图像数量（1–10，默认 1）

aspect_ratio

string

覆盖输出宽高比（默认跟随第一张输入图）

resolution

string

分辨率（1k 或 2k，默认 1k）

环境变量

变量

必填

说明

XAIAPI_KEY

✅

xAI API 密钥

XAIAPI_BASE_URL

API 基础地址（默认 https://api.x.ai/v1），可填写代理地址

IMAGE_PROXY_DOMAIN

图片代理域名，替换返回 URL 中的 imgen.x.ai

HTTP_PROXY

HTTP/HTTPS 网络代理地址（如 http://127.0.0.1:7890）

代理示例

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

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/fl0w1nd/grok-image-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server