A
security-
licenseA
qualityA 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 -
📦 프로젝트 개요
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 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
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.
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
Related MCP Servers
- Asecurity-licenseAqualityA 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 -115MIT License
- Asecurity-licenseAqualityA 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.Last updated -1144MIT License
- Asecurity-licenseAqualityA 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.Last updated -24516MIT License