Ideogram Images

🚀 Ideogram MCP Server

A Model Context Protocol (MCP) server that uses the Ideogram API to provide image generation capabilities.

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

✨ Features

• Generate images based on prompts.
• Customizable parameters:
  • Aspect ratio
  • Model selection
  • Magic prompt
  • Style type
  • Negative prompt
  • Number of images to generate

🚀 Quick Start

📦 Installation

1. Install the required dependencies:

npm install

2. Set up environment variables: Create a .env file and add the following content:

IDEOGRAM_API_KEY=your_api_key_here

3. Build the project:

npm run build

4. (Optional) Install globally:

npm link

💻 Usage Examples

MCP Tools

generate_image

A tool for generating images.

Required Parameters:

• prompt: The prompt used to generate the image

Optional Parameters:

• aspect_ratio: The aspect ratio of the image
  • ASPECT_1_1
  • ASPECT_4_3
  • ASPECT_3_4
  • ASPECT_16_9
  • ASPECT_9_16
• model: The model to use
  • V_1
  • V_1_TURBO
  • V_2
  • V_2_TURBO
• magic_prompt_option: Magic prompt settings
  • AUTO
  • ON
  • OFF
• style_type: The generation style
• negative_prompt: A description of content to exclude
• num_images: The number of images to generate (1 - 8)

Basic Usage

const result = await use_mcp_tool({
  server_name: "ideagram-mcp-server",
  tool_name: "generate_image",
  parameters: {
    prompt: "a beautiful sunset over the mountains"
  }
});

🔧 Technical Details

Development Guide

1. Clone the repository:

git clone https://github.com/sunwood-ai-labs/ideagram-mcp-server.git
cd ideagram-mcp-server

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

4. Build the project:

npm run build

5. Run tests:

npm test

🤝 Contribution Guide

1. Fork the repository and create a new branch in your local clone:

git checkout -b feature/new-feature

2. Commit your changes and push to the remote repository:

git add .
git commit -m "Add new feature"
git push origin feature/new-feature

3. Create a Pull Request to the main branch.