Ideogramm 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

⚡️ 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-Build
npm run watch ... Entwicklungsmodus (automatischer Build)
npm run lint ... Code-Linting
npm 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-tags

Einzelheiten finden Sie unter docs/npm-deploy.md !

📄 Lizenz

MIT

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

generate_image

Ein Model Context Protocol-Server, der Bildgenerierungsfunktionen mithilfe der Ideogram-API bereitstellt und es Benutzern ermöglicht, Bilder aus Textaufforderungen mit anpassbaren Parametern zu erstellen.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP TemplateIO
Lucker631
A
security
F
license
A
quality
A Model Context Protocol server that provides an image generation tool using Templated.io, allowing users to create customized images based on templates with text and image layers.
Last updated -
TypeScript
Image Generation MCP Server
manascb1344
A
security
A
license
A
quality
A Model Context Protocol server that enables high-quality image generation using the Flux.1 Schnell model via Together AI with customizable parameters.
Last updated -
1
29
8
JavaScript
MIT License
Image Generation MCP Server
sarthakkimtani
A
security
A
license
A
quality
A Model Context Protocol server that enables generation of high-quality images using the Flux.1 Schnell model via Together AI, allowing users to create images from text prompts with customizable dimensions.
Last updated -
1
8
Python
MIT License
OpenAI MCP
jezweb
-
security
A
license
-
quality
A 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.
Last updated -
14
1
JavaScript
MIT License

View all related MCP servers

Ideogram MCP Server