📦 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: Image Generation MCP Server
⚡️ 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
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.