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

📦 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: Image Generation MCP Server

⚡️ 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

Bifurcar este repositorio
Crea una nueva rama ( git checkout -b feature/awesome )
Confirmar cambios (los mensajes de confirmación deben estar en japonés y se recomiendan usar emojis)
Creación de solicitudes push y pull