claude-foundry-image

Claude Code plugin que da a cada proyecto y cada conversación un generador de imágenes respaldado por tu propio despliegue de Azure AI Foundry (API de imágenes MAI, p.ej. MAI-Image-2.5-Pro).

• Servidor MCP (server/server.mjs) — Node ≥ 18, cero dependencias. Herramientas: generate_image, edit_image, check_config.

• Skill generate-image — enseña a Claude cuándo usar las herramientas, cómo expandir una línea simple en un prompt utilizable, dimensiones válidas, dónde escribir archivos.

• Skill setup — guía de configuración única.

Las imágenes se escriben en disco; solo la ruta del archivo entra en la conversación. Sin base64 en el contexto.

Install

claude plugin marketplace add jpaarhuis/claude-foundry-image

claude plugin install foundry-image@jpaarhuis

O en una sesión interactiva: /plugin → Marketplaces → añadir jpaarhuis/claude-foundry-image → instalar foundry-image.

Related MCP server: gpt-image-mcp

Configure (once)

El servidor lee su configuración de las variables de entorno. Ponlas en ~/.claude/settings.json bajo env — un archivo, todas las plataformas, solo Claude Code lo ve:

{
  "env": {
    "MAI_IMAGE_ENDPOINT": "https://<resource>.services.ai.azure.com/mai/v1/images/generations",
    "MAI_IMAGE_DEPLOYMENT": "MAI-Image-2.5-Pro",
    "MAI_IMAGE_API_KEY": "<key>",
    "MAI_IMAGE_OUTPUT_DIR": "C:/Users/<you>/Pictures/ai"
  }
}

O configúralas como variables de entorno del usuario del SO (setx en Windows, export en tu perfil de shell en macOS/Linux). Reinicia Claude Code de cualquier manera.

Luego, en cualquier sesión: "ejecuta check_config" o /foundry-image:setup para una guía paso a paso.

Use

Solo pregunta: "maak een hero image voor de README, donker, isometrisch, geen tekst". Claude expande el prompt, elige dimensiones, escribe el PNG (en el repositorio cuando corresponde) y devuelve la ruta.

Parámetros de las herramientas, como referencia:

Reglas de dimensiones de la API MAI: cada lado ≥ 768 px y ancho × alto ≤ 1 048 576 px. Por lo tanto, 1024x1024, 1024x768, 1280x800 funcionan; 1024x1536 y 1920x1080 no.

Why env vars and not a config file or setup dialog?

Los plugins de Claude Code no tienen almacenamiento secreto por plugin ni interfaz de configuración. La convención — la misma que usa el plugin oficial de GitHub para su PAT — es la expansión ${VAR} en el .mcp.json del plugin, con el usuario configurando las variables una vez. settings.json → env es el lugar de menor fricción para eso: viaja con tu perfil de Claude Code, se aplica a cada proyecto y sobrevive a las actualizaciones del plugin.

Si quieres sacar la clave de archivos de texto plano, cárgala en el entorno desde un almacén de secretos al iniciar sesión (Key Vault, CLI de 1Password, Administrador de credenciales de Windows) — al servidor no le importa de dónde viene la variable.

Develop

npm test

Ejecuta una prueba de humo offline: handshake MCP, listado de herramientas, comprobaciones de dimensiones, errores de configuración faltante y verifica que check_config nunca filtre una clave.

License

MIT