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