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 -
📦 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 TypeScriptnpm run watch... modo de desarrollo (compilación automática)npm run lint... Revisión de códigonpm 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)
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.
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.
- ⚡️ Inicio rápido
- Especificaciones de la herramienta MCP
- 🧑💻 Desarrollar, construir y probar
- 🗂️ Estructura del directorio
- 📝 Contribuciones
- 🚀 Implementar y lanzar
- 📄 Licencia
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