Ideogramm MCP-Server

🎨 Ideogramm MCP-Server

Ein Model Context Protocol (MCP)-Server, der Bildgenerierungsfunktionen mithilfe der Ideogram-API bereitstellt. Kompatibel mit Ideogram 3.0 !

https://github.com/user-attachments/assets/041553d3-6fbc-4dfa-b149-d195dcb9e8f8

📋 Funktionen

Eingabeaufforderungsbasierte Bildgenerierung
Anpassbare Parameter
- Seitenverhältnis
- Modellauswahl (V1, V2, V3 )
- Magische Eingabeaufforderung
- Stiltyp
- Negative Aufforderungen
- Anzahl der generierten Bilder
- Stilreferenzfunktion (Neu in Ideogram 3.0)
  - URL-Referenzbilder (bis zu 3)
  - Stilcode
  - Zufälliger Stil

🚀 Einrichtung

Installieren Sie die erforderlichen Abhängigkeiten:

npm install

Umgebungsvariablen festlegen: Erstellen Sie eine .env Datei und fügen Sie ihr Folgendes hinzu:

IDEOGRAM_API_KEY=your_api_key_here

Bauen:

npm run build

(Optional) Global installieren:

npm link

💻 Anwendung

MCP-Tools

Bild generieren

Ein Tool zum Erstellen von Bildern.

Erforderliche Parameter:

prompt : Die für die Bildgenerierung zu verwendende Eingabeaufforderung

Optionale Parameter:

aspect_ratio : Das Seitenverhältnis des Bildes.
- ASPECT_1_1
- ASPECT_4_3
- ASPECT_3_4
- ASPECT_16_9
- ASPECT_9_16
model : Das zu verwendende Modell
- V_1
- V_1_TURBO
- V_2
- V_2_TURBO
- V_3
- V_3_TURBO
- V_3_DEFAULT
- V_3_QUALITY
magic_prompt_option : Magic-Prompt-Einstellung
- AUTO
- ON
- OFF
style_type : Der generierte Stil
negative_prompt : Beschreibung des Elements, das Sie ausschließen möchten
num_images : Anzahl der zu generierenden Bilder (1-8)
style_reference : Stilreferenzoption (neu in Ideogram 3.0)
- urls : Array von URLs für Referenzbilder (maximal 3)
- style_code : Stilcode
- random_style : Ob ein zufälliger Stil verwendet werden soll (Boolesch)

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: "ASPECT_16_9",
    model: "V_3_QUALITY", // Ideogram 3.0の最高品質モデル
    num_images: 1
  }
});

// スタイル参照機能を使用する例
const resultWithStyle = await use_mcp_tool({
  server_name: "ideagram-mcp-server",
  tool_name: "generate_image",
  arguments: {
    prompt: "A cat sitting on a window sill",
    aspect_ratio: "ASPECT_1_1",
    model: "V_3_DEFAULT",
    style_reference: {
      urls: [
        "https://example.com/reference_image1.jpg",
        "https://example.com/reference_image2.jpg"
      ]
    }
  }
});

// ランダムスタイルを使用する例
const resultWithRandomStyle = await use_mcp_tool({
  server_name: "ideagram-mcp-server",
  tool_name: "generate_image",
  arguments: {
    prompt: "A futuristic cityscape",
    model: "V_3_TURBO",
    style_reference: {
      random_style: true
    }
  }
});

🔧 Entwicklung

Verzeichnisstruktur

ideagram-mcp-server/
├── src/
│   ├── index.ts          # メインのサーバーコード
│   └── ideogram-client.ts # Ideogram APIクライアント
├── package.json
├── tsconfig.json
└── README.md

Skript

npm run build : TypeScript kompilieren
npm run watch : Im Entwicklungsmodus ausführen (Dateiänderungen beobachten)
npm run lint : Lint Ihren Code
npm test : Tests ausführen

📄 Lizenz

MIT

🤝 Beiträge

Forken Sie dieses Repository
Erstellen Sie einen neuen Zweig ( git checkout -b feature/amazing-feature )
Übernehmen Sie die Änderungen ( git commit -m '✨ feat: Add amazing feature' )
Pushen zum Zweig ( git push origin feature/amazing-feature )
Erstellen einer Pull-Anforderung

🚀 Bereitstellen

Dieses Paket wird mithilfe von GitHub Actions automatisch auf npm veröffentlicht.

So veröffentlichen Sie eine neue Version

Veröffentlichen mithilfe von Tags

Paketversionen aktualisieren:
npm version patch # パッチバージョンを上げる # または npm version minor # マイナーバージョンを上げる # または npm version major # メジャーバージョンを上げる
Push-Tags:
git push --follow-tags

Dadurch kann GitHub Actions die neue Version automatisch auf npm veröffentlichen.

Weitere Informationen

Ausführliche Anweisungen zur Bereitstellung und Konfiguration finden Sie in der Bereitstellungsdokumentation .

Ideogram MCP Server

Integrations