Name: Ideogram MCP Server
Author: Sunwood-ai-labs

📦 프로젝트 개요

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

Related MCP server: Image Generation MCP Server

⚡️ 퀵스타트

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 └── ...（省略）