What is Ideogram Mcp Server

Ideogram MCP Server is an implementation of the Model Context Protocol (MCP) designed for the Ideogram AI API. It provides tools for generating, editing, and describing images using advanced AI models.

Use cases

Use cases include creating custom artwork from textual descriptions, enhancing existing images, generating visual content for social media, and automating image generation for marketing materials.

How to use

To use the Ideogram MCP Server, clone the repository, install the dependencies, build the project, and configure it in your Cursor settings with your API key.

Key features

Key features include generating images from text descriptions, editing images with masks, generating descriptions for images, downloading images, and using prompt templates for common tasks.

Where to use

Ideogram MCP Server can be used in various fields such as digital art creation, content generation, marketing, and any application that requires image manipulation and generation.

Ideogram MCP Server

A Model Context Protocol (MCP) server implementation for the Ideogram AI API. This server provides tools for generating, editing, and describing images using Ideogram’s powerful AI models.

Features

• Generate images from text descriptions
• Edit existing images using masks
• Generate descriptions for images
• Download generated images to local directory
• Prompt templates for common operations

Installation

1. Clone the repository

git clone https://github.com/flowluap/ideogram-mcp-server.git
cd ideogram-mcp-server

2. Install dependencies

npm install

3. Build the project

npm run build

Cursor Integration

To use this MCP in Cursor, add the following configuration to your Cursor settings (Settings > AI > Model Context Protocol):

{
  "mcps": {
    "ideogram-mcp": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_DIST/index.js"
      ],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace:

• PATH_TO_YOUR_DIST/index.js with the absolute path to your built index.js file
• your-api-key-here with your actual Ideogram API key

Example (redacted):

{
  "mcps": {
    "ideogram-mcp": {
      "command": "node",
      "args": [
        "/path/to/ideogram-mcp-server/dist/index.js"
      ],
      "env": {
        "IDEOGRAM_API_KEY": "xxxxx-REDACTED-xxxxx"
      }
    }
  }
}

Available Tools

1. generate

   • Generate images from text prompts
   • Parameters:
     • prompt: string (required)
     • aspect_ratio: string (optional) - One of: ASPECT_1_1, ASPECT_16_9, ASPECT_9_16, ASPECT_4_3, ASPECT_3_4
     • model: string (optional) - One of: V_1, V_2, V_2_TURBO
     • magic_prompt_option: string (optional) - One of: AUTO, ON, OFF
     • num_images: number (optional) - Between 1 and 8
     • seed: number (optional) - Between 0 and 2147483647

2. edit

   • Edit images using masks
   • Parameters:
     • image_file: string (required) - Base64 or file path
     • mask: string (required) - Base64 or file path
     • prompt: string (required)
     • model: string (required) - One of: V_2, V_2_TURBO

3. describe

   • Generate descriptions for images
   • Parameters:
     • image_file: string (required) - Base64 or file path

4. download_images

   • Download generated images to local directory
   • Parameters:
     • urls: string[] (required) - Array of image URLs
     • output_dir: string (required) - Output directory path

Prompt Templates

1. generate_image
   • Template for generating images
   • Parameters:
     • description: string

Development

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

# Run linter
npm run lint

Requirements

• Node.js >= 18.0.0
• Ideogram API key

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request