Ideogram MCP Server

📦 Project Overview

A TypeScript tool that allows you to use Ideogram API (v3.0) via MCP server
Multi-function including image generation, style reference, magic prompt, aspect ratio, model selection, etc.
Can be used immediately with Claude Desktop and other MCP clients

⚡️ Quick Start

If you want to connect to Claude Desktop or other MCP clients at lightning speed,
Just copy and paste the JSON snippet below into your configuration file!

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": [
        "@sunwood-ai-labs/ideagram-mcp-server"
      ],
      "env": {
        "IDEOGRAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠️ MCP Tool Specifications

generate_image

Parameter list (latest version)

Parameters	Type	explanation	Required/Optional	remarks
prompt	string	Image generation prompt (English recommended)	Required
aspect_ratio	string	Aspect ratio (e.g. "1x1", "16x9", "4x3", etc.)	any	15 types
resolution	string	Resolution (see official documentation, 69 types in total)	any
seed	integer	Random number seed (to ensure reproducibility)	any	0 to 2147483647
magic_prompt	string	Magic prompt ("AUTO"	"ON"	"OFF"
rendering_speed	string	Rendering speed for v3 ("TURBO"	"DEFAULT"	"QUALITY"
style_codes	string[]	8-character style code sequence	any
style_type	string	Style type ("AUTO"	"GENERAL"	"REALISTIC"
negative_prompt	string	Exclusions (English recommended)	any
num_images	number	Number of generated images (1 to 8)	any
style_reference	object	Style Reference (New in Ideogram 3.0)	any	Details below
└ urls	string[]	Reference image URL array (up to 3)	any
└ style_code	string	Style Code	any
└ random_style	boolean	Use random style	any
output_dir	string	Image storage directory (default: "docs")	any
base_filename	string	Base for saved filename (default: "ideogram-image")	any	Timestamp and ID assignment
blur_mask	boolean	Blur the edges of the image (set to true for mask compositing)	any	Default: false

📝 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: "16x9",
    rendering_speed: "QUALITY",
    num_images: 2,
    style_reference: {
      urls: [
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
      ],
      random_style: false
    },
    blur_mask: true
  }
});

🧑‍💻 Develop, build, and test

npm run build ... TypeScript build
npm run watch ... development mode (automatic build)
npm run lint ... Code linting
npm test ... run tests

🗂️ Directory structure

ideagram-mcp-server/
├── assets/
├── docs/
│   └── ideogram-image_2025-05-18T06-31-45-777Z.png
├── src/
│   ├── tools/
│   ├── types/
│   ├── utils/
│   ├── ideogram-client.ts
│   ├── index.ts
│   ├── server.ts
│   └── test.ts
├── .env.example
├── package.json
├── tsconfig.json
├── README.md
└── ...（省略）

📝 Contributions

Fork this repository
Create a new branch ( git checkout -b feature/awesome )
Commit changes (Commit messages should be in Japanese and emojis are recommended!)
Push and pull request creation

🚀 Deploy & Release

Automatic npm publishing with GitHub Actions
Version update → Automatic deployment by pushing tags

npm version patch|minor|major
git push --follow-tags

For details, see docs/npm-deploy.md !

📄 License

MIT

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

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.

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

Related MCP Servers

MCP TemplateIO
Lucker631
A
security
F
license
A
quality
A Model Context Protocol server that provides an image generation tool using Templated.io, allowing users to create customized images based on templates with text and image layers.
Last updated -
TypeScript
Image Generation MCP Server
manascb1344
A
security
A
license
A
quality
A Model Context Protocol server that enables high-quality image generation using the Flux.1 Schnell model via Together AI with customizable parameters.
Last updated -
1
29
8
JavaScript
MIT License
Image Generation MCP Server
sarthakkimtani
A
security
A
license
A
quality
A Model Context Protocol server that enables generation of high-quality images using the Flux.1 Schnell model via Together AI, allowing users to create images from text prompts with customizable dimensions.
Last updated -
1
8
Python
MIT License
OpenAI MCP
jezweb
-
security
-
license
-
quality
A Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.
Last updated -
JavaScript
MIT License

View all related MCP servers