Skip to main content
Glama


πŸ“¦ ν”„λ‘œμ νŠΈ κ°œμš”

  • 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 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
└── ...(省η•₯οΌ‰

πŸ“ κΈ°μ—¬

  1. 이 μ €μž₯μ†Œλ₯Ό 포크

  2. μƒˆλ‘œμš΄ 브랜치 생성 ( git checkout -b feature/awesome )

  3. λ³€κ²½ 컀밋 (컀밋 λ©”μ‹œμ§€λŠ” 일본어 + 이λͺ¨ν‹°μ½˜ μΆ”μ²œ!)

  4. ν‘Έμ‹œ & ν’€λ¦­ λ§Œλ“€κΈ°


πŸš€ 배포 및 μΆœμ‹œ

  • GitHub Actionsμ—μ„œ μžλ™ npm 곡개

  • 버전 μ—…λ°μ΄νŠΈ β†’ νƒœκ·Έ push둜 μžλ™ 배포

npm version patch|minor|major
git push --follow-tags

μžμ„Έν•œ λ‚΄μš©μ€ docs/npm-deploy.md λ₯Ό μ°Έμ‘°ν•˜μ‹­μ‹œμ˜€!


πŸ“„ λΌμ΄μ„ΌμŠ€

MIT


Available Tools

1 tool
generate_imageC

Generate an image using Ideogram AI

Inputs: prompt (required), aspect_ratio, resolution, seed, +11 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 1 tool

    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 recent community issues

    Related MCP Connectors

    Related MCP Servers