remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Used for environment variable management to store Ideogram API credentials
Used for source code hosting and version control for the Ideogram MCP Server project
Used for package distribution and dependency management for the Ideogram MCP Server

🎨 Ideogram MCP Server

A Model Context Protocol (MCP) server that provides image generation functionality using the Ideogram API

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

📋 Features

Prompt-based image generation
Customizable parameters
- Aspect Ratio
- Model Selection
- Magic Prompt
- Style Type
- Negative prompts
- Number of generated images

🚀 Setup

Install the required dependencies:

npm install

Set environment variables: Create a .env file and add the following to it:

IDEOGRAM_API_KEY=your_api_key_here

Build:

npm run build

(Optional) Install globally:

npm link

💻 How to use

MCP Tools

generate_image

A tool for generating images.

Required parameters:

prompt : The prompt to use for image generation

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 setting
- AUTO
- ON
- OFF
style_type : The generated style
negative_prompt : Description of the element you want to exclude
num_images : Number of images to generate (1-8)

Usage Example

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
  }
});

🔧 Development

Directory Structure

ideagram-mcp-server/
├── src/
│   ├── index.ts          # メインのサーバーコード
│   └── ideogram-client.ts # Ideogram APIクライアント
├── package.json
├── tsconfig.json
└── README.md

script

npm run build : Compile TypeScript
npm run watch : Run in development mode (watch file changes)
npm run lint : Lint your code
npm test : Run tests

📄 License

MIT

🤝 Contributions

Fork this repository
Create a new branch ( git checkout -b feature/amazing-feature )
Commit the changes ( git commit -m '✨ feat: Add amazing feature' )
Push to the branch ( git push origin feature/amazing-feature )
Create a pull request

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

generate_image

A Model Context Protocol server that provides image generation capabilities using the Ideogram API, allowing users to create images from text prompts with customizable parameters.

Related Resources

Reddit Discussion about this server