Skip to main content
Glama
Sign In
deenesjakoruzh
Ideogram MCP Server

Ideogram MCP Server

by Sunwood-ai-labs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

📦 Descripción general del proyecto

  • Una herramienta de TypeScript que le permite utilizar la API de Ideogram (v3.0) a través del servidor MCP

  • Multifunción que incluye generación de imágenes, referencia de estilo, aviso mágico, relación de aspecto, selección de modelo, etc.

  • Se puede utilizar inmediatamente con Claude Desktop y otros clientes MCP

Related MCP server: OpenAI MCP

⚡️ Inicio rápido

Si desea conectarse a Claude Desktop u otros clientes MCP a la velocidad del rayo,
¡Simplemente copie y pegue el fragmento JSON a continuación en su archivo de configuración! ✨

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": [
        "@sunwood-ai-labs/ideagram-mcp-server"
      ],
      "env": {
        "IDEOGRAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Especificaciones de la herramienta MCP

generar_imagen

Lista de parámetros (última versión)

Parámetros

Tipo

explicación

Obligatorio/Opcional

observaciones

inmediato

cadena

Indicación de generación de imágenes (se recomienda usar inglés)

Requerido

relación de aspecto

cadena

Relación de aspecto (por ejemplo, "1x1", "16x9", "4x3", etc.)

cualquier

15 tipos

resolución

cadena

Resolución (ver documentación oficial, 69 tipos en total)

cualquier

semilla

entero

Semilla de número aleatorio (para garantizar la reproducibilidad)

cualquier

0 a 2147483647

aviso mágico

cadena

Indicación mágica ("AUTO"

"EN"

"APAGADO"

velocidad de renderizado

cadena

Velocidad de renderizado para v3 ("TURBO"

"POR DEFECTO"

"CALIDAD"

códigos de estilo

cadena[]

Secuencia de código de estilo de 8 caracteres

cualquier

tipo_de_estilo

cadena

Tipo de estilo ("AUTO"

"GENERAL"

"REALISTA"

mensaje negativo

cadena

Exclusiones (se recomienda inglés)

cualquier

número de imágenes

número

Número de imágenes generadas (1 a 8)

cualquier

referencia de estilo

objeto

Referencia de estilo (Novedad en Ideograma 3.0)

cualquier

Detalles a continuación

└ URL

cadena[]

Matriz de URL de imágenes de referencia (hasta 3)

cualquier

└ código de estilo

cadena

Código de estilo

cualquier

└ estilo aleatorio

booleano

Utilice un estilo aleatorio

cualquier

directorio_de_salida

cadena

Directorio de almacenamiento de imágenes (predeterminado: "docs")

cualquier

nombre_de_archivo_base

cadena

Base para el nombre del archivo guardado (predeterminado: "ideogram-image")

cualquier

Marca de tiempo y asignación de ID

máscara borrosa

booleano

Desenfocar los bordes de la imagen (establecer como verdadero para la composición de máscara)

cualquier

Predeterminado: falso

📝 Ejemplo de uso

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
  }
});

🧑‍💻 Desarrollar, construir y probar

  • npm run build ... Compilación de TypeScript

  • npm run watch ... modo de desarrollo (compilación automática)

  • npm run lint ... Revisión de código

  • npm test ... ejecutar pruebas

🗂️ Estructura del directorio

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

📝 Contribuciones

  1. Bifurcar este repositorio

  2. Crea una nueva rama ( git checkout -b feature/awesome )

  3. Confirmar cambios (los mensajes de confirmación deben estar en japonés y se recomiendan usar emojis)

  4. Creación de solicitudes push y pull

🚀 Implementar y lanzar

  • Publicación automática de npm con GitHub Actions

  • Actualización de versión → Implementación automática mediante el envío de etiquetas

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

Para obtener más detalles, consulte docs/npm-deploy.md .

📄 Licencia

Instituto Tecnológico de Massachusetts (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.

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    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

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches