Servidor MCP de ideogramas

📦 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

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

🚀 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)

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

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.

Tools

generate_image

Un servidor de protocolo de contexto de modelo que proporciona capacidades de generación de imágenes utilizando la API de ideogramas, lo que permite a los usuarios crear imágenes a partir de indicaciones de texto con parámetros personalizables.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP TemplateIO
Lucker631
A
security
F
license
A
quality
A 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 -
TypeScript
Image Generation MCP Server
manascb1344
A
security
A
license
A
quality
A Model Context Protocol server that enables high-quality image generation using the Flux.1 Schnell model via Together AI with customizable parameters.
Last updated -
1
29
8
JavaScript
MIT License
Image Generation MCP Server
sarthakkimtani
A
security
A
license
A
quality
A 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 -
1
8
Python
MIT License
OpenAI MCP
jezweb
-
security
-
license
-
quality
A Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.
Last updated -
JavaScript
MIT License

View all related MCP servers

Ideogram MCP Server