grok-image MCP server
Commit 14. Okt. 2026Ermöglicht es AI-Clients, Bilder über die xAI Grok API zu generieren, zu bearbeiten und zu stylen.
Auch bekannt als codeChap/mcp-server-grok-image, mcp-server-grok-image
- Stars
- 0
- Tools
- 37
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.0
- Letzter Commit
- 14. Okt. 2026
- Lizenz
- —
Was ist grok-image MCP?
Ermöglicht es AI-Clients, Bilder über die xAI Grok API zu generieren, zu bearbeiten und zu stylen. Er stellt 37 Tools bereit, etwa generate_image, edit_image, headshot.
Zusammenfassung generiert aus dem README des Projekts
Über grok-image MCP server
Dieser auf Rust basierende MCP server ermöglicht es Entwicklern, die KI-Clients wie Claude Desktop nutzen, visuelle Inhalte über die xAI Grok API zu generieren und zu modifizieren. Durch die Verbindung via stdio fungiert er als Brücke zu hochentwickelten Bildmodellen wie grok-imagine-image-2.0. Nutzer können neue Visuals aus Textbeschreibungen erstellen, spezifische künstlerische Stile wie Aquarell oder Pixel-Art anwenden und technische Parameter wie Seitenverhältnisse und Auflösungen bis zu 2k anpassen.
Über die reine Erstellung hinaus bietet der Server Tools, um bestehende Bilder mittels natürlicher Sprache zu bearbeiten. Er unterstützt Multi-Image-Editing, indem bis zu fünf Quellbilder referenziert werden können. Ein spezialisiertes Headshot-Tool kann zudem Porträts erweitern, indem es weiße Hintergründe hinzufügt und Schultern vervollständigt. Um den Server zu nutzen, musst du einen xAI API key in einer lokalen Config bereitstellen. Das System erlaubt zudem die Definition eigener Style-Templates, um konsistente visuelle Ergebnisse über verschiedene Prompts hinweg sicherzustellen.
Was du damit machen kannst
- 1Stilisierte Kunstwerke erstellenGeneriere ein neues Bild aus einem Text-Prompt unter Verwendung eines spezifischen künstlerischen Stils wie Anime oder Ölgemälde.
- 2Bestehende Bilder modifizierenNutze Anweisungen in natürlicher Sprache, um ein Bild oder einen Satz von bis zu fünf Quellbildern zu bearbeiten.
- 3Professionelle Porträts produzierenVerwandle ein Quellporträt in ein professionelles Business-Headshot mit einem sauberen weißen Hintergrund.
- 4Eigene visuelle Identitäten definierenErstelle und nutze einzigartige Style-Templates, um Prompts in eine konsistente Ästhetik einzubetten.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
grok-image MCP tools 37
Erkannt aus dem READMEgenerate_imageedit_imageheadshotlist_stylespromptmodelaspect_ratioresolutionqualityresponse_formatstyleimage_url
| generate_image | — | |
| edit_image | — | |
| headshot | — | |
| list_styles | — | |
| prompt | — | |
| model | — | |
| aspect_ratio | — | |
| resolution | — | |
| quality | — | |
| response_format | — | |
| style | — | |
| image_url | — |
Alle 37 Tools anzeigenWeniger Tools anzeigen
imagesimageclothingnotespronoungravitycontent_widthcanvas_widthoutput_pathwatercoloroil-paintingpencil-sketchpixel-artanimepop-artart-nouveaucinematicportraitmacroaerialstudionoirvintagegrok-imagine-imagegrok-imagine-image-quality
| images | — | |
| image | — | |
| clothing | — | |
| notes | — | |
| pronoun | — | |
| gravity | — | |
| content_width | — | |
| canvas_width | — | |
| output_path | — | |
| watercolor | — | |
| oil-painting | — | |
| pencil-sketch | — | |
| pixel-art | — | |
| anime | — | |
| pop-art | — | |
| art-nouveau | — | |
| cinematic | — | |
| portrait | — | |
| macro | — | |
| aerial | — | |
| studio | — | |
| noir | — | |
| vintage | — | |
| grok-imagine-image | — | |
| grok-imagine-image-quality | — |
Konfiguration
RUST_LOG
| Name | Beschreibung | Typ |
|---|---|---|
| RUST_LOG | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarcodechap/mcp-server-grok-image is public and reachablegithub.com/codechap/mcp-server-grok-image ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)No licenseBefund
- Commit oder Release im letzten JahrLast commit or release 2026-10-14github.com/codechap/mcp-server-grok-image ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell37 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenmcp-server-grok-image
An MCP (Model Context Protocol) server for xAI's Grok image generation API. Built in Rust, exposes image generation and editing as MCP tools.
Communicates via stdio using JSON-RPC 2.0, like all MCP servers.
Tools
| Tool | Description |
|---|---|
generate_image |
Generate an image from a text prompt |
edit_image |
Edit an existing image using natural language instructions |
headshot |
Corporate headshot from a source portrait (pad to 3:2 + fixed edit prompt) |
list_styles |
List available image styles for use with generate_image |
generate_image
Generate an image from a text description.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
prompt |
string | yes | Text description of the desired image |
model |
string | no | Model to use (default: grok-imagine-image-2.0) |
n |
integer | no | Number of images to generate (1-10, default 1) |
aspect_ratio |
string | no | Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9, 5:2, auto |
resolution |
string | no | Output resolution: 1k (~1024px, default) or 2k (~2048px) |
quality |
string | no | low, medium, or auto (2.0 only; omitted = auto. Auto currently serves low for generation) |
response_format |
string | no | Output format: url (default, temporary) or b64_json |
style |
string | no | Style name to apply (use list_styles to see options) |
When a style is set, the prompt is wrapped in the style's template. For example, with style: "watercolor" and prompt: "a cat on a roof", the API receives "a cat on a roof, as a watercolor painting". Avoid including style language in the prompt itself when using this parameter.
The response includes the resolved prompt so you can see exactly what was sent to the API.
edit_image
Edit an existing image using natural language instructions.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
image_url |
string | no* | URL, base64 data URI, or local file path of the source image. Mutually exclusive with images. |
images |
string[] | no* | Up to 5 source images for multi-image editing. Reference them in the prompt as <IMAGE_0>, <IMAGE_1>, … |
prompt |
string | yes | Natural language edit instructions |
model |
string | no | Model to use (default: grok-imagine-image-2.0) |
n |
integer | no | Number of variations to generate (1-10, default 1) |
aspect_ratio |
string | no | Same set as generate_image, including 21:9 and 5:2 |
resolution |
string | no | Output resolution: 1k (~1024px, default) or 2k (~2048px) |
quality |
string | no | low, medium, or auto (2.0 only; omitted = auto. Auto currently serves medium for editing) |
response_format |
string | no | Output format: url (default, temporary) or b64_json |
* Provide either image_url or images.
Note: The style parameter is intentionally not available on edit_image -- edit prompts are instructions (e.g. "remove the background"), not descriptions, so wrapping them in style templates would produce nonsense.
headshot
Expand-only portrait fix (Gemini pipeline equivalent on Imagine). Does not reframe pose, cut out hair, or redesign the person.
- Resize full source (default 550px wide) — never crop
- Letterbox with white gutters to canvas width (default 780)
- Call
grok-imagine-image-2.0at quality medium: complete cut-off shoulders if needed; clean solid white background; keep face/hair/pose/clothing/logos
No cutout / no rembg / no transparent alpha — same job as the original Gemini headshot skill.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
image |
string | yes | Local path, http(s) URL, or data: URI |
clothing |
string | no | For missing-shoulder fill only |
notes |
string | no | Must-preserve details (glasses, exact logo text, …) |
pronoun |
string | no | his / her / their (default their) |
gravity |
string | no | Letterbox gravity (North default) |
content_width |
integer | no | Resize width before pad (default 550) |
canvas_width |
integer | no | Padded width (default 780) |
resolution |
string | no | 1k or 2k (default 2k) |
output_path |
string | no | Optional final path (also under save_dir) |
n |
integer | no | Variations (1–10, default 1) |
quality |
string | no | low / medium / auto (default medium) |
model |
string | no | Default grok-imagine-image-2.0 |
Padded intermediate: save_dir/headshot-padded_*.jpg.
list_styles
Returns all available image styles with their name, description, and prompt template. No parameters.
Built-in Styles
| Style | Description |
|---|---|
watercolor |
Watercolor painting style |
oil-painting |
Oil painting with visible brushstrokes |
pencil-sketch |
Detailed pencil sketch |
pixel-art |
Retro pixel art |
anime |
Anime style illustration |
pop-art |
Bold pop art style |
art-nouveau |
Art nouveau with flowing organic lines |
cinematic |
Cinematic photography with dramatic lighting |
portrait |
Professional portrait photography |
macro |
Extreme macro photography |
aerial |
Aerial drone photography |
studio |
Studio photography on clean background |
noir |
Dark film noir style |
vintage |
Faded vintage photograph |
Available Models
| Model | Notes |
|---|---|
grok-imagine-image-2.0 (default) |
Optional quality (low / medium / auto), up to 5 edit references, 21:9 and 5:2. Auto currently serves low for generation and medium for editing. |
grok-imagine-image |
1.0. Still available; no quality param. |
grok-imagine-image-quality |
Retires 2026-11-02. After that the slug is served by grok-imagine-image-2.0 at quality: low ($0.01 less per image than the quality model). |
Prerequisites
- Rust (edition 2024)
- An xAI API key from console.x.ai
Setup
Create the config file:
mkdir -p ~/.config/mcp-server-grok-image
Create ~/.config/mcp-server-grok-image/config.toml:
api_key = "xai-..."
Custom Styles
Add custom styles to your config file. Custom styles with the same name as a built-in will override it.
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"
Templates must contain the {prompt} placeholder. Any custom style missing it will be skipped with a warning at startup.
Build
cargo build --release
This produces target/release/mcp-server-grok-image.
For development:
cargo build # debug build
cargo run # run in dev mode
RUST_LOG=debug cargo run # run with debug logging
MCP Configuration
Add to your Claude Desktop config (~/.config/Claude/claude_desktop_config.json):
{
"mcpServers": {
"grok-image": {
"command": "/path/to/mcp-server-grok-image"
}
}
}
Project Structure
src/
main.rs process entry (stdio MCP)
config.rs TOML / env config
styles.rs built-in + custom styles
grok.rs xAI request/response types
params.rs MCP tool params + validation
image_io.rs data URIs, local files, mime, fetch
headshot.rs letterbox pad + expand prompt
server.rs MCP tools and Grok HTTP
License
MIT
grok-image MCP Fragen
Welche Tools bietet grok-image MCP?
Er stellt 37 Tools bereit, darunter generate_image, edit_image, headshot, list_styles, prompt.
Wofür wird das Headshot-Tool verwendet?
Das Headshot-Tool ist eine Erweiterungsfunktion für Porträts, die ein Quellbild vergrößert und Grok nutzt, um abgeschnittene Schultern vor einem sauberen weißen Hintergrund zu ergänzen.