Ideagram MCP Server

🚀 ideoGram MCP Server

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

The link to the related resource: Click here

✨ Features

• Prompt-based image generation
• Customizable parameters:
  • Aspect ratio
  • Model selection
  • Magic prompt
  • Style type
  • Negative prompt
  • Number of generated images

📦 Installation

1. Install the necessary 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

Basic Usage

MCP Tool - generate_image

This tool is used to generate 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 be used
  • 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 the content to be excluded
• num_images: The number of images to generate (1 - 8)

Advanced Usage

# Generate an image based on a prompt
mcp generate-image --prompt "A little cat sitting on a park bench" --width 500 --height 300

🔧 Technical Details

Install Dependencies

Install project dependencies using npm:

npm install

Start the Development Server

To start the development server, run:

npm run dev

Access http://localhost:3000 to view the documentation.

🤝 Contribution

1. Fork the project repository.
2. Create a new branch for your feature implementation:

git checkout -b feature/your-feature-name

3. Commit your changes:

git add .
git commit -m "Add new feature: Your new feature description"

4. Push the branch to the remote repository:

git push origin feature/your-feature-name

5. Create a Pull Request to the main branch.

Your contributions will help us improve this project!