Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

ideagram-mcp-server

MCP.Pizza Chef: Sunwood-ai-labs

The ideagram-mcp-server is a Model Context Protocol (MCP) server that integrates the Ideogram API to provide advanced AI-powered image generation capabilities. It allows users to generate images based on textual prompts with a variety of customizable parameters such as aspect ratio, model selection, magic prompts, and style types. This server facilitates seamless interaction between LLMs and image generation tools, enabling real-time, context-aware visual content creation within AI workflows. It supports flexible configuration to tailor image outputs to specific needs, making it ideal for developers building AI-enhanced applications that require dynamic and creative image generation.

Use This MCP server To

Generate images from text prompts in AI workflows Customize image aspect ratios for diverse outputs Select different AI models for varied image styles Apply magic prompts to enhance image creativity Integrate style types for tailored visual aesthetics Enable real-time image generation in chatbots Support AI-assisted design and content creation Automate visual content generation in applications

README

🎨 Ideogram MCP Server

GitHub GitHub package.json version GitHub issues GitHub pull requests npm npm

Ideogram APIを使用して画像生成機能を提供するModel Context Protocol (MCP) サーバー

Timeline.125.mp4

📋 機能

  • プロンプトに基づく画像生成
  • カスタマイズ可能なパラメータ
    • アスペクト比
    • モデル選択
    • マジックプロンプト
    • スタイルタイプ
    • ネガティブプロンプト
    • 生成画像数

🚀 セットアップ

  1. 必要な依存関係をインストール:
npm install
  1. 環境変数の設定: .envファイルを作成し、以下の内容を追加:
IDEOGRAM_API_KEY=your_api_key_here
  1. ビルド:
npm run build
  1. (オプション)グローバルにインストール:
npm link

💻 使用方法

MCPツール

generate_image

画像を生成するためのツール。

必須パラメータ:

  • prompt: 画像生成に使用するプロンプト

オプションパラメータ:

  • aspect_ratio: 画像のアスペクト比
    • ASPECT_1_1
    • ASPECT_4_3
    • ASPECT_3_4
    • ASPECT_16_9
    • ASPECT_9_16
  • model: 使用するモデル
    • V_1
    • V_1_TURBO
    • V_2
    • V_2_TURBO
  • magic_prompt_option: マジックプロンプトの設定
    • AUTO
    • ON
    • OFF
  • style_type: 生成スタイル
  • negative_prompt: 除外したい要素の説明
  • num_images: 生成する画像の数(1-8)

使用例

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_2",
    num_images: 1
  }
});

🔧 開発

ディレクトリ構造

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

スクリプト

  • npm run build: TypeScriptのコンパイル
  • npm run watch: 開発モードでの実行(ファイル変更の監視)
  • npm run lint: コードのリント
  • npm test: テストの実行

📄 ライセンス

MIT

🤝 コントリビューション

  1. このリポジトリをフォーク
  2. 新しいブランチを作成 (git checkout -b feature/amazing-feature)
  3. 変更をコミット (git commit -m '✨ feat: Add amazing feature')
  4. ブランチにプッシュ (git push origin feature/amazing-feature)
  5. プルリクエストを作成

ideagram-mcp-server FAQ

How do I install the ideagram-mcp-server?
You can install it via npm using '@sunwood-ai-labs/ideagram-mcp-server' package, following the GitHub repository instructions.
Can I customize the image generation parameters?
Yes, the server supports customization of aspect ratio, model selection, magic prompts, style types, and more.
Does ideagram-mcp-server support multiple AI models?
Yes, it allows selection among different models to generate varied image styles.
How does ideagram-mcp-server integrate with LLMs?
It acts as an MCP server exposing image generation capabilities that LLMs like OpenAI, Claude, and Gemini can call via the MCP client.
Is real-time image generation supported?
Yes, the server is designed for real-time interaction, enabling dynamic image creation during AI workflows.
What languages or frameworks is ideagram-mcp-server compatible with?
It is primarily a Node.js-based server, compatible with any MCP client or host that can communicate over the MCP protocol.
Are there any usage limits or licensing considerations?
Usage limits depend on the Ideogram API plan; licensing details are available in the GitHub repository.
How can I contribute or report issues?
Contributions and issue reports can be made via the GitHub repository's issues and pull requests sections.