Skip to main content
Glama


📦 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-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

  1. Forken Sie dieses Repository

  2. Erstellen Sie einen neuen Zweig ( git checkout -b feature/awesome )

  3. Änderungen festschreiben (Commit-Nachrichten sollten auf Japanisch sein und Emojis werden empfohlen!)

  4. 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


Available Tools

1 tool
generate_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

    C2.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers