@qmediat.io/ideogram-mcp

Servidor MCP para la API de Ideogram V3 — genera, edita, remezcla, amplía y describe imágenes desde Claude Code, Claude Desktop o cualquier cliente MCP.

¿Por qué este servidor?

• 7 herramientas — cobertura completa de Ideogram V3 (generar, editar, remezclar, reencuadrar, reemplazar fondo, ampliar, describir)

• Seguridad ante todo — protección SSRF, rechazo de enlaces simbólicos, validación de Content-Type, prevención de path traversal, validación de respuestas con Zod (detalles)

• 2 dependencias de ejecución — @modelcontextprotocol/sdk + zod. Sin axios, sin form-data, sin librerías HTTP

• API nativa de Ideogram — endpoints V3 directos, no a través de proxies como fal.ai o Replicate

• Endurecido para producción — reintentos con backoff exponencial, manejo de filtros de seguridad, resiliencia ante fallos parciales

Related MCP server: ideogram-mcp-server

Inicio rápido

npm install -g @qmediat.io/ideogram-mcp

O úsalo directamente:

npx @qmediat.io/ideogram-mcp

Requiere IDEOGRAM_API_KEY — obtén una en ideogram.ai/manage-api.

Configuración

Claude Code

Añade a ~/.claude.json → mcpServers:

{
  "ideogram": {
    "command": "npx",
    "args": ["-y", "@qmediat.io/ideogram-mcp"],
    "env": {
      "IDEOGRAM_API_KEY": "your-api-key",
      "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
    }
  }
}

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": ["-y", "@qmediat.io/ideogram-mcp"],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key",
        "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
      }
    }
  }
}

Variables de entorno

Herramientas disponibles

Parámetros comunes

Seguridad

Este servidor está diseñado con un enfoque de confianza cero y dependencias mínimas:

• Protección SSRF — descargas solo HTTPS, lista blanca de nombres de host, bloqueo de redirecciones

• Rechazo de enlaces simbólicos — lstat() rechaza enlaces simbólicos creados por el usuario antes de leer

• Validación de Content-Type — las descargas deben ser image/*, rechazando páginas de error HTML/JSON

• Validación de respuestas con Zod — las respuestas de la API se analizan mediante esquemas, sin conversiones de tipo a ciegas

• Prevención de path traversal — lista blanca de extensiones + comprobación de contención con path.relative()

Detalles completos en SECURITY.md.

Desarrollo

git clone https://github.com/qmediat/ideogram-mcp.git
cd ideogram-mcp
npm install
npm run build

Ejecuta localmente:

IDEOGRAM_API_KEY=your-key node dist/index.js

Contribuciones

Consulta CONTRIBUTING.md para las pautas de arquitectura y los requisitos de PR.

Licencia

MIT — Quantum Media Technologies