Ideogram MCP Server

📦 프로젝트 개요

Ideogram API (v3.0)를 MCP 서버를 통해 사용할 수있는 TypeScript 도구
이미지 생성, 스타일 참조, 매직 프롬프트, 종횡비, 모델 선택 등 다기능
Claude Desktop 및 기타 MCP 클라이언트에서 즉시 사용 OK

⚡️ 퀵스타트

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 build
npm 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

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