Grok Imagine Image MCP Server

Grok Imagine图像MCP服务器

](https://www.npmjs.com/package/grok-imagine-image-mcp-server) 

日语版README在这里

用于xAI的Grok Imagine Image API的MCP（模型上下文协议）服务器。支持从文本提示生成图像和编辑现有图像。

npx快速入门

# Set your API key
export XAI_API_KEY="xai-your-api-key"

# Run the server
npx grok-imagine-image-mcp-server

特性

• 图像生成：根据文本提示生成新图像
• 图像编辑：使用提示编辑现有图像（仅限grok想象图像）
• 批处理：通过CLI处理多个图像
• 各种纵横比（1:1、4:3、16:9等）
• 分辨率：1k（标准）
• 一次生成多个图像（最多10个）
• MCP响应中的可选缩略图预览

支持的型号

需求

• Node.js 18.0.0或更高版本
• xAI API密钥（从 console.x.ai)

安装

选项1:npx（推荐）

npx grok-imagine-image-mcp-server

选项2：全局安装

npm install -g grok-imagine-image-mcp-server
grok-imagine-image-mcp-server

配置

环境变量

Claude桌面配置

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "grok-imagine-image": {
      "command": "npx",
      "args": ["-y", "grok-imagine-image-mcp-server"],
      "env": {
        "XAI_API_KEY": "xai-your-api-key-here"
      }
    }
  }
}

工具

generate_image

根据文本提示生成图像。

edit_image

编辑现有图像（仅限grok想象图像）。

\*其中之一 image_path, image_base64，或 image_url 是必需的

备注edit_image工具使用源图像作为参考，并重新生成整个图像。它保持了整体构图和风格，但不是像素级的修复。最适合进行样式转换、主题替换和场景修改。

批处理CLI

使用批处理CLI一次处理多个映像：

# Run batch with config file
npx grok-imagine-image-batch batch.json

# Estimate cost only
npx grok-imagine-image-batch batch.json --estimate-only

# Custom output directory
npx grok-imagine-image-batch batch.json --output-dir ./images --format json

CLI选项

批处理配置文件

{
  "jobs": [
    {
      "prompt": "A beautiful sunset over mountains",
      "output_path": "sunset.jpg",
      "aspect_ratio": "16:9"
    },
    {
      "prompt": "Change to nighttime scene",
      "image_path": "input.jpg",
      "output_path": "edited.jpg"
    }
  ],
  "output_dir": "./output",
  "max_concurrent": 3,
  "default_model": "grok-imagine-image",
  "retry_policy": {
    "max_retries": 2,
    "retry_delay_ms": 1000
  }
}

看 examples/ 目录以获取更多配置示例。

支持的纵横比

支持的决议

用法示例

# Image generation
Generate an image of a sunset over mountains with aspect ratio 16:9

# Image editing
Change the background of this image to space

API 参考

• 文档: docs..ai/docs/guides/图像生成

发展

git clone https://github.com/ex-takashima/grok-imagine-image-mcp-server.git
cd grok-imagine-image-mcp-server
npm install
npm run build
npm start

许可证

麻省理工学院

作者

高岛俊二