de en es ja ko ru zh

ideogram-mcp

Name: ideogram-mcp
Author: qmediat

by qmediat

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

@qmediat.io/ideogram-mcp

Ideogram V3 API용 MCP 서버 — Claude Code, Claude Desktop 또는 모든 MCP 클라이언트에서 이미지를 생성, 편집, 리믹스, 업스케일, 설명할 수 있습니다.

npm version license TypeScript

이 서버를 사용하는 이유

7가지 도구 — Ideogram V3 전체 기능 지원 (생성, 편집, 리믹스, 리프레임, 배경 교체, 업스케일, 설명)
보안 우선 — SSRF 보호, 심볼릭 링크 거부, Content-Type 검증, 경로 탐색 방지, Zod 응답 검증 (자세히)
런타임 의존성 2개 — @modelcontextprotocol/sdk + zod. axios, form-data, HTTP 라이브러리 없음
네이티브 Ideogram API — fal.ai나 Replicate를 통한 프록시가 아닌 직접 V3 엔드포인트 사용
프로덕션 강화 — 지수 백오프 재시도, 안전 필터 처리, 부분 실패 복원력

Related MCP server: ideogram-mcp-server

빠른 시작

npm install -g @qmediat.io/ideogram-mcp

또는 직접 사용:

npx @qmediat.io/ideogram-mcp

IDEOGRAM_API_KEY가 필요합니다 — ideogram.ai/manage-api에서 발급받으세요.

구성

Claude Code

~/.claude.json → mcpServers에 추가:

{
  "ideogram": {
    "command": "npx",
    "args": ["-y", "@qmediat.io/ideogram-mcp"],
    "env": {
      "IDEOGRAM_API_KEY": "your-api-key",
      "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
    }
  }
}

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": ["-y", "@qmediat.io/ideogram-mcp"],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key",
        "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
      }
    }
  }
}

환경 변수

변수	필수	기본값	설명
`IDEOGRAM_API_KEY`	예	—	Ideogram API 키 (여기서 발급)
`IDEOGRAM_OUTPUT_DIR`	아니요	`/tmp/ideogram-output`	이미지를 저장할 폴더. 절대 경로 사용 (예: `/home/user/images/ideogram`)

사용 가능한 도구

도구	설명	주요 매개변수
`ideogram_generate`	텍스트 프롬프트에서 이미지 생성	`prompt`, `aspect_ratio`, `rendering_speed`, `style_type`, `num_images`
`ideogram_describe`	이미지에 대한 텍스트 설명 생성	`image` (파일 경로)
`ideogram_edit`	마스크 기반 인페인팅으로 이미지 영역 편집	`image`, `mask`, `prompt`
`ideogram_remix`	새 프롬프트로 이미지 변환	`image`, `prompt`, `image_weight` (0-100)
`ideogram_reframe`	새 해상도로 이미지 확장 (아웃페인팅)	`image`, `resolution` (69가지 유효 크기)
`ideogram_replace_background`	전경을 유지하면서 배경 교체	`image`, `prompt`
`ideogram_upscale`	가이드 향상으로 업스케일	`image`, `resemblance` (0-100), `detail` (0-100)

공통 매개변수

매개변수	사용 가능한 도구	값
`rendering_speed`	generate, edit, remix, reframe, replace_background	`FLASH`, `TURBO`, `DEFAULT`, `QUALITY`
`magic_prompt`	generate, edit, remix, replace_background, upscale	`AUTO`, `ON`, `OFF`
`style_type`	generate, edit, remix	`AUTO`, `GENERAL`, `REALISTIC`, `DESIGN`, `FICTION`
`aspect_ratio`	generate, remix	`1x1`, `16x9`, `9x16`, `4x3`, `3x4` 및 10개 더
`num_images`	모든 도구	`1`-`8`
`seed`	모든 도구	`0`-`2,147,483,647`

보안

이 서버는 제로 트러스트, 최소 의존성 접근 방식으로 설계되었습니다:

SSRF 보호 — HTTPS 전용 다운로드, 호스트 이름 허용 목록, 리디렉션 차단
심볼릭 링크 거부 — lstat()가 읽기 전에 사용자 생성 심볼릭 링크를 거부
Content-Type 검증 — 다운로드는 image/*여야 하며, HTML/JSON 오류 페이지 거부
Zod 응답 검증 — API 응답을 스키마로 파싱, 맹목적 타입 캐스트 없음
경로 탐색 방지 — 확장자 허용 목록 + path.relative() 포함 검사

자세한 내용은 SECURITY.md를 참조하세요.

개발

git clone https://github.com/qmediat/ideogram-mcp.git
cd ideogram-mcp
npm install
npm run build

로컬에서 실행:

IDEOGRAM_API_KEY=your-key node dist/index.js

기여

아키텍처 지침과 PR 요구 사항은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT — Quantum Media Technologies

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Ideogram MCP Server
Image & Video Processing AI & Machine Learning
flowluap
A
license
D
quality
D
maintenance
Enables image generation, editing, and description using Ideogram AI's models through natural language.
Updated a year ago (2025-03-28 11:04 UTC)
4
36
4
MIT
ideogram-mcp-server
AI & Machine Learning Image & Video Processing
takeshijuan
A
license
Not graded
quality
C
maintenance
Enables LLM applications to generate, edit, describe, upscale, remix, reframe, and replace backgrounds in images using the Ideogram AI API.
Updated 5 months ago (2026-03-31 07:06 UTC)
20
MIT
Ideogram V3 MCP Server
AI & Machine Learning Image & Video Processing
runapi-ai
A
license
B
quality
A
maintenance
MCP server for Ideogram V3 model line enabling image editing, reframing, remixing, and text-to-image generation with task polling and pricing checks through RunAPI.
Updated a month ago (2026-07-31 09:34 UTC)
7
66
Apache 2.0
my-image-mcp
Image & Video Processing AI & Machine Learning
less55093-collab
A
license
A
quality
C
maintenance
Enables image generation, editing, and composition using any OpenAI-compatible Images API within MCP clients, Dify, and n8n, delivering results as image blocks, structured fields, or resource links.
Updated a month ago (2026-07-16 08:20 UTC)
4
MIT

View all related MCP servers

Related MCP Connectors

mcp
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
mcp
Generate images with any major model — one API key, one prepaid balance, one MCP.
Frenchie
OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/qmediat/ideogram-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server