A
licenseNot graded
qualityF
maintenanceA server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.
18
MIT
Ideogram MCP Server
π¦ νλ‘μ νΈ κ°μ
Ideogram API (v3.0)λ₯Ό MCP μλ²λ₯Ό ν΅ν΄ μ¬μ©ν μμλ TypeScript λꡬ
μ΄λ―Έμ§ μμ±, μ€νμΌ μ°Έμ‘°, λ§€μ§ ν둬ννΈ, μ’ ν‘λΉ, λͺ¨λΈ μ ν λ± λ€κΈ°λ₯
Claude Desktop λ° κΈ°ν MCP ν΄λΌμ΄μΈνΈμμ μ¦μ μ¬μ© OK
Related MCP server: OpenAI MCP
β‘οΈ ν΅μ€ννΈ
Claude Desktopμ΄λ λ€λ₯Έ MCP ν΄λΌμ΄μΈνΈμ νμ μ°κ³λ₯Ό μνλ€λ©΄,
μλ JSON μ€ λν«μ μ€μ νμΌμ λ³΅μ¬ OK β¨
{
"mcpServers": {
"ideogram": {
"command": "npx",
"args": [
"@sunwood-ai-labs/ideagram-mcp-server"
],
"env": {
"IDEOGRAM_API_KEY": "your_api_key_here"
}
}
}
}π οΈ MCP ν΄ μ¬μ
generate_image
νλΌλ―Έν° μΌλ(μ΅μ ν)
맀κ°λ³μ | κΈν | μ€λͺ | νμ/μ ν | λΉκ³ |
prompt | λ¬Έμμ΄ | μ΄λ―Έμ§ μμ± ν둬ννΈ(μμ΄ κΆμ₯) | νμ | |
aspect_ratio | λ¬Έμμ΄ | μ’ ν‘λΉ(μ: "1x1", "16x9", "4x3" λ±) | μ ν | 15μ’ λ₯ |
resolution | λ¬Έμμ΄ | ν΄μλ(곡μ λ¬Έμ μ°Έμ‘°, μ΄ 69μ’ ) | μ ν | |
seed | integer | λμ μλ(μ¬νμ± λ΄λ³΄μ©) | μ ν | 0ο½2147483647 |
magic_prompt | λ¬Έμμ΄ | λ§€μ§ ν둬ννΈ("AUTO" | "ON" | "OFF") |
rendering_speed | λ¬Έμμ΄ | v3μ© λ λλ§ μλ("TURBO" | "DEFAULT" | "QUALITY") |
style_codes | string[] | 8μ μ€νμΌ μ½λ λ°°μ΄ | μ ν | |
style_type | λ¬Έμμ΄ | μ€νμΌ νμ ("AUTO" | "GENERAL" | "REALISTIC" |
negative_prompt | λ¬Έμμ΄ | μ μΈ μμ(μμ΄ κΆμ₯) | μ ν | |
num_images | number | μμ± μ΄λ―Έμ§ μ(1~8) | μ ν | |
style_reference | κ°μ²΄ | μ€νμΌ μ°Έμ‘°(Ideogram 3.0 μλ‘μ΄ κΈ°λ₯) | μ ν | μλ μμΈ |
β urls | string[] | μ°Έμ‘° μ΄λ―Έμ§ URL λ°°μ΄(μ΅λ 3κ°) | μ ν | |
β style_code | λ¬Έμμ΄ | μ€νμΌ μ½λ | μ ν | |
β random_style | λΆμΈ | λλ€ μ€νμΌ μ¬μ© | μ ν | |
output_dir | λ¬Έμμ΄ | μ΄λ―Έμ§ μ μ₯ λλ ν 리(κΈ°λ³Έκ°: "docs") | μ ν | |
base_filename | λ¬Έμμ΄ | μ μ₯ νμΌ μ΄λ¦μ κΈ°λ°(κΈ°λ³Έκ°: "ideogram-image") | μ ν | νμμ€ν¬νγ»ID λΆμ¬ |
blur_mask | λΆμΈ | μ΄λ―Έμ§ κ°μ₯μ리 νλ¦Ό(trueλ‘ λ§μ€ν¬ ν©μ±) | μ ν | κΈ°λ³Έκ°: false |
π μ¬μ© μ
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
}
});π§βπ» κ°λ°, λΉλ, ν μ€νΈ
npm run buildnpm run watch... κ°λ° λͺ¨λ(μλ λΉλ)npm run lint... μ½λ λ¦°νΈnpm test... ν μ€νΈ μ€ν
ποΈ λλ ν 리 ꡬμ±
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
βββ ...οΌηη₯οΌπ κΈ°μ¬
μ΄ μ μ₯μλ₯Ό ν¬ν¬
μλ‘μ΄ λΈλμΉ μμ± (
git checkout -b feature/awesome)λ³κ²½ μ»€λ° (μ»€λ° λ©μμ§λ μΌλ³Έμ΄ + μ΄λͺ¨ν°μ½ μΆμ²!)
νΈμ & νλ¦ λ§λ€κΈ°
π λ°°ν¬ λ° μΆμ
GitHub Actionsμμ μλ npm 곡κ°
λ²μ μ λ°μ΄νΈ β νκ·Έ pushλ‘ μλ λ°°ν¬
npm version patch|minor|major
git push --follow-tagsμμΈν λ΄μ©μ docs/npm-deploy.md λ₯Ό μ°Έμ‘°νμμμ€!
π λΌμ΄μΌμ€
MIT
Available Tools
1 toolgenerate_imageC
Generate an image using Ideogram AI
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | The prompt to use for generating the image (must be in English) | |
| aspect_ratio | No | The aspect ratio for the generated image (see official docs for all 15 values) | |
| resolution | No | The resolution for the generated image (see official docs for all 69 values) | |
| seed | No | Random seed. Set for reproducible generation. | |
| magic_prompt | No | Whether to use magic prompt | |
| rendering_speed | No | Rendering speed for v3 (TURBO/DEFAULT/QUALITY) | |
| style_codes | No | Array of 8-char style codes | |
| style_type | No | The style type for generation | |
| style_reference_images | No | A set of images to use as style references (max 10MB, JPEG/PNG/WebP) | |
| negative_prompt | No | Description of what to exclude from the image (must be in English) | |
| num_images | No | Number of images to generate (1-8) | |
| style_reference | No | Style reference options for Ideogram 3.0 | |
| output_dir | No | Directory to save generated images (default: 'docs'). | |
| base_filename | No | Base filename for saved images (default: 'ideogram-image'). Timestamp and image ID will be appended automatically. | |
| blur_mask | No | Apply a blurred mask to the image edges (using a fixed mask image). If true, the output image will have blurred/feathered edges. (default: false) |
TDQS
C2.7/5.0
Behavior2/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden for behavioral disclosure. The description only states the basic action without mentioning rate limits, authentication needs, output format, error conditions, or cost implications. For a complex image generation tool with 15 parameters, this leaves significant behavioral gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that states the core purpose without unnecessary elaboration. It's appropriately sized for a tool name that clearly indicates its function, and there's no wasted verbiage or structural issues.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness2/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (15 parameters, no output schema, no annotations), the description is inadequate. It doesn't explain what the tool returns, error handling, performance characteristics, or typical use patterns. For an image generation tool with many configuration options, more context is needed to help the agent use it effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters3/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all parameters thoroughly. The description adds no parameter information beyond what's in the schema. According to scoring rules, when schema coverage is high (>80%), the baseline is 3 even with no param info in the description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose3/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Generate an image using Ideogram AI' states the basic action (generate) and resource (image) but lacks specificity. It doesn't mention what kind of images, quality levels, or typical use cases. Without sibling tools, differentiation isn't needed, but the purpose remains vague beyond the basic verb-noun pairing.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines2/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. The description doesn't mention prerequisites, ideal scenarios, or limitations. Without sibling tools, there's no need for differentiation, but the absence of any usage context leaves the agent with no guidance on appropriate application.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
C2.9/5.0
Disambiguation5/5
With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'generate_image' has a clearly distinct and unambiguous purpose.
Naming Consistency5/5
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'generate_image' follows a clear verb_noun pattern.
Tool Count2/5
One tool is too few for a server named 'Ideogram MCP Server', which suggests a broader scope for image generation or AI tasks. A single tool feels thin and limited for such a domain.
Completeness2/5
The tool surface is severely incomplete for an image generation server. It only offers generation with no options for editing, listing, deleting, or managing images, creating significant gaps in functionality.
Maintenance
ActivityInactive
ResponsivenessNo issues
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
A Model Context Protocol server for Wix AI tools
MCP server for Qwen Image 3 AI image generation
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yoβ¦
Multi-model AI image and video generator. 14 models behind one OAuth-secured MCP endpoint.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA 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.341MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that provides image generation capabilities using Google's Gemini 2 API, allowing users to generate multiple images with customizable parameters like prompts, aspect ratios, and person generation settings.1705MIT
- AlicenseDqualityFmaintenanceA Model Context Protocol server that enables generating and editing images using OpenAI's gpt-image-1 model, allowing AI assistants to create and modify images from text prompts.28418MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sunwood-ai-labs/ideagram-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server