Grok Image

mcp服务器grok镜像

用于xAI的Grok图像生成API的MCP（模型上下文协议）服务器。内置Rust，将图像生成和编辑作为MCP工具公开。

与所有MCP服务器一样，使用JSON-RPC 2.0通过stdio进行通信。

工具

generate_image

根据文本描述生成图像。

参数：

设置样式后，提示将被包裹在样式的模板中。例如，与 style: "watercolor" 和 prompt: "a cat on a roof"，API接收 "a cat on a roof, as a watercolor painting"。使用此参数时，避免在提示本身中包含样式语言。

响应包括已解析的提示，因此您可以确切地看到发送到API的内容。

edit_image

使用自然语言指令编辑现有图像。

参数：

注： style 参数在上故意不可用 edit_image --编辑提示是指令（例如“删除背景”），而不是描述，因此将它们包装在样式模板中会产生无稽之谈。

list_styles

返回所有可用的图像样式及其名称、描述和提示模板。没有参数。

内置样式

可用型号

注：遗产 grok-2-image-1212 模型不支持 aspect_ratio 或 resolution 参数。

先决条件

• 铁锈（2024年版）
• 来自的xAI API密钥 console.x.ai

设置

创建配置文件：

mkdir -p ~/.config/mcp-server-grok-image

创建 ~/.config/mcp-server-grok-image/config.toml:

api_key = "xai-..."

自定义样式

将自定义样式添加到配置文件中。与内置样式同名的自定义样式将覆盖它。

api_key = "xai-..."

[[styles]]
name = "my-style"
description = "My custom look"
template = "{prompt}, in my custom style"

[[styles]]
name = "watercolor"
description = "My watercolor variant"
template = "{prompt}, as a loose expressive watercolor with ink outlines"

模板必须包含 {prompt} 占位符。任何缺少的自定义样式都将被跳过，并在启动时发出警告。

构建

cargo build --release

这产生 target/release/mcp-server-grok-image.

发展：

cargo build              # debug build
cargo run                # run in dev mode
RUST_LOG=debug cargo run # run with debug logging

MCP配置

添加到您的Claude桌面配置(~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "grok-image": {
      "command": "/path/to/mcp-server-grok-image"
    }
  }
}

项目结构

src/
  main.rs  - everything: config, styles, API types, MCP server, tool definitions

许可证

麻省理工学院