Ideogram MCP Server

📦 Projektübersicht
Ein TypeScript-Tool, mit dem Sie die Ideogram-API (v3.0) über den MCP-Server verwenden können
Multifunktional, einschließlich Bildgenerierung, Stilreferenz, magische Eingabeaufforderung, Seitenverhältnis, Modellauswahl usw.
Kann sofort mit Claude Desktop und anderen MCP-Clients verwendet werden
Related MCP server: OpenAI MCP
⚡️ Schnellstart
Wenn Sie sich blitzschnell mit Claude Desktop oder anderen MCP-Clients verbinden möchten,
Kopieren Sie einfach den folgenden JSON-Ausschnitt und fügen Sie ihn in Ihre Konfigurationsdatei ein! ✨
{
"mcpServers": {
"ideogram": {
"command": "npx",
"args": [
"@sunwood-ai-labs/ideagram-mcp-server"
],
"env": {
"IDEOGRAM_API_KEY": "your_api_key_here"
}
}
}
}🛠️ MCP-Tool-Spezifikationen
Bild generieren
Parameterliste (neueste Version)
Parameter | Typ | Erläuterung | Erforderlich/Optional | Bemerkungen |
prompt | Schnur | Eingabeaufforderung zur Bildgenerierung (Englisch empfohlen) | Erforderlich | |
Seitenverhältnis | Schnur | Seitenverhältnis (z. B. „1x1“, „16x9“, „4x3“ usw.) | beliebig | 15 Typen |
Auflösung | Schnur | Auflösung (siehe offizielle Dokumentation, insgesamt 69 Typen) | beliebig | |
Samen | ganze Zahl | Zufallszahlen-Startwert (um die Reproduzierbarkeit sicherzustellen) | beliebig | 0 bis 2147483647 |
magische Eingabeaufforderung | Schnur | Magische Eingabeaufforderung ("AUTO" | "AN" | "AUS" |
Rendering-Geschwindigkeit | Schnur | Rendering-Geschwindigkeit für v3 („TURBO“ | "STANDARD" | "QUALITÄT" |
Stilcodes | Zeichenfolge[] | 8-stellige Codesequenz | beliebig | |
Stiltyp | Schnur | Stiltyp ("AUTO" | "ALLGEMEIN" | "REALISTISCH" |
negative_prompt | Schnur | Ausschlüsse (Englisch empfohlen) | beliebig | |
Anzahl Bilder | Nummer | Anzahl der generierten Bilder (1 bis 8) | beliebig | |
Stilreferenz | Objekt | Stilreferenz (Neu in Ideogram 3.0) | beliebig | Details unten |
└ URLs | Zeichenfolge[] | Referenzbild-URL-Array (bis zu 3) | beliebig | |
└ Stilcode | Schnur | Stilcode | beliebig | |
└ zufälliger Stil | Boolescher Wert | Zufälligen Stil verwenden | beliebig | |
Ausgabeverzeichnis | Schnur | Bildspeicherverzeichnis (Standard: „docs“) | beliebig | |
Basisdateiname | Schnur | Basis für gespeicherten Dateinamen (Standard: „Ideogramm-Bild“) | beliebig | Zeitstempel und ID-Zuweisung |
Unschärfemaske | Boolescher Wert | Die Ränder des Bildes verwischen (für die Maskenzusammenstellung auf „true“ setzen) | beliebig | Standard: false |
📝 Anwendungsbeispiel
const result = await use_mcp_tool({
server_name: "ideagram-mcp-server",
tool_name: "generate_image",
arguments: {
prompt: "A beautiful sunset over mountains",
aspect_ratio: "16x9",
rendering_speed: "QUALITY",
num_images: 2,
style_reference: {
urls: [
"https://example.com/ref1.jpg",
"https://example.com/ref2.jpg"
],
random_style: false
},
blur_mask: true
}
});🧑💻 Entwickeln, bauen und testen
npm run build... TypeScript-Buildnpm run watch... Entwicklungsmodus (automatischer Build)npm run lint... Code-Lintingnpm test... Tests ausführen
🗂️ Verzeichnisstruktur
ideagram-mcp-server/
├── assets/
├── docs/
│ └── ideogram-image_2025-05-18T06-31-45-777Z.png
├── src/
│ ├── tools/
│ ├── types/
│ ├── utils/
│ ├── ideogram-client.ts
│ ├── index.ts
│ ├── server.ts
│ └── test.ts
├── .env.example
├── package.json
├── tsconfig.json
├── README.md
└── ...(省略)📝 Beiträge
Forken Sie dieses Repository
Erstellen Sie einen neuen Zweig (
git checkout -b feature/awesome)Änderungen festschreiben (Commit-Nachrichten sollten auf Japanisch sein und Emojis werden empfohlen!)
Push- und Pull-Anforderungserstellung
🚀 Bereitstellen und Freigeben
Automatische NPM-Veröffentlichung mit GitHub Actions
Versionsupdate → Automatisches Deployment durch Pushen von Tags
npm version patch|minor|major
git push --follow-tagsEinzelheiten finden Sie unter docs/npm-deploy.md !
📄 Lizenz
MIT
Available Tools
1 toolgenerate_imageC
Generate an image using Ideogram AI
Inputs: prompt (required), aspect_ratio, resolution, seed, +11 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'generate_image' has a clearly distinct and unambiguous purpose.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'generate_image' follows a clear verb_noun pattern.
One tool is too few for a server named 'Ideogram MCP Server', which suggests a broader scope for image generation or AI tasks. A single tool feels thin and limited for such a domain.
The tool surface is severely incomplete for an image generation server. It only offers generation with no options for editing, listing, deleting, or managing images, creating significant gaps in functionality.
Maintenance
Related MCP Connectors
MCP server for Qwen Image 3 AI image generation
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Generate AI images and videos from any compatible MCP client.
MCP server for Flux AI image generation
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.19MIT
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.1MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that provides image generation capabilities using Google's Gemini 2 API, allowing users to generate multiple images with customizable parameters like prompts, aspect ratios, and person generation settings.16MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that enables generating and editing images using OpenAI's gpt-image-1 model, allowing AI assistants to create and modify images from text prompts.218MIT