Sunwood Ai Labs Ideagram MCP Server

🚀 Eden MCP Server

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

🚀 Quick Start

Prerequisites

• Node.js and npm installed on your machine.

Installation Steps

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

✨ Features

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

💻 Usage Examples

MCP Tool

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 style for image generation.
• negative_prompt: A description of elements to be excluded.
• 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",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "ASPECT_16_9",
    model: "V_2",
    num_images: 1
  }
});

🔧 Technical Details

Project Structure

Eden MCP Server
├── src
│   ├── services          # API request handling
│   ├── models            # Model definitions
│   ├── routes            # Route definitions
│   └── middleware        # Middleware
└── package.json         # Project dependencies and scripts

How to Contribute

1. Fork the project to your repository.
2. Create a new feature branch in your local repository: git checkout -b feature/your-feature-name
3. Commit your changes: git add . && git commit -m "Add new feature: your feature name"
4. Push your branch to the remote repository: git push origin feature/your-feature-name
5. Create a Pull Request to the main repository.

📄 License

Project License