🎨 pruna-mcp-server

Servidor MCP para Pruna AI: generación, edición, escalado y creación de vídeo ultrarrápidos directamente desde tu asistente de IA.

Pruna AI es una API de inferencia especializada en la generación de imágenes y vídeos. Ofrece generación de imágenes en menos de 2 segundos a partir de 0,005 $/imagen, con modelos para texto a imagen, edición de imágenes, escalado y generación de vídeo. Este servidor MCP envuelve su API para que cualquier cliente compatible con MCP (Claude Desktop, Kiro, Cursor) pueda generar contenido visual de forma nativa.

Cumple con la Especificación MCP 2025-11-25.

Características

• 6 herramientas MCP: generate_image, edit_image, upscale_image, generate_video, list_models, upload_file

• 7 prompts MCP: Fotos de producto, puesta en escena virtual, visuales para redes sociales, arte conceptual de juegos, creatividades publicitarias, anuncios de vídeo, mejora de imagen

• 2 recursos MCP: Catálogo pruna://models para descubrir modelos sin llamadas a herramientas

• 18 modelos: 10 de texto a imagen, 3 de edición, 1 de escalado, 4 de vídeo

• Sincronización/asincronización inteligente: Sincronización para modelos de imagen rápidos, asincronización con sondeo para vídeo

• Gestión de archivos transparente: Pasa rutas locales o URLs; la carga automática está gestionada

• Retorno de imagen MCP nativo: Bloques ImageContent para clientes que admiten visualización en línea

• Cumplimiento total de MCP: Anotaciones de herramientas, contenido estructurado, notificaciones de progreso

Inicio rápido

# With uvx (zero install)
uvx pruna-mcp-server

# Or with pip
pip install pruna-mcp-server
pruna-mcp

Configura tu clave API: obtén una en pruna.ai (ve al portal de desarrolladores o contacta con Pruna para solicitar acceso):

# macOS Keychain (recommended)
security add-generic-password -a $USER -s PRUNA_API_KEY -w "your-api-key"

# Or environment variable
export PRUNA_API_KEY="your-api-key"

Configuración del cliente MCP

Kiro CLI

Añádelo a la configuración de tu agente (p. ej., ~/.kiro/agents/default.json):

En mcpServers:

"pruna": {
  "command": "sh",
  "args": ["-c", "PRUNA_API_KEY=$(security find-generic-password -a $USER -s PRUNA_API_KEY -w) uv run --directory /path/to/pruna-mcp-server pruna-mcp"],
  "autoApprove": ["generate_image", "edit_image", "upscale_image", "generate_video", "list_models", "upload_file"]
}

En tools, añade: "@pruna/*"

En allowedTools, añade: "generate_image", "edit_image", "upscale_image", "generate_video", "list_models", "upload_file"

Nota: Los agentes de Kiro utilizan una lista blanca de tools con sintaxis @server-name/* y una lista allowedTools. Ambas deben incluir las herramientas de Pruna para que estén disponibles.

Claude Desktop

Añádelo a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "pruna": {
      "command": "sh",
      "args": ["-c", "PRUNA_API_KEY=$(security find-generic-password -a $USER -s PRUNA_API_KEY -w) /path/to/uv run --directory /path/to/pruna-mcp-server pruna-mcp"]
    }
  }
}

Importante: Usa la ruta completa a uv (p. ej., /Users/you/.local/bin/uv); Claude Desktop inicia procesos con un PATH mínimo que no incluye ~/.local/bin.

Nota: Claude Desktop no renderiza ImageContent en línea en el chat. La imagen se genera y guarda localmente; Claude hará referencia a la ruta del archivo en su respuesta.

Cursor

Añádelo a .cursor/mcp.json:

{
  "mcpServers": {
    "pruna": {
      "command": "uvx",
      "args": ["pruna-mcp-server"],
      "env": { "PRUNA_API_KEY": "your-api-key" }
    }
  }
}

Herramientas

Las herramientas de imagen devuelven tanto un bloque de metadatos JSON como un bloque ImageContent MCP nativo (base64, para imágenes < 5 MB).

Prompts

Plantillas de flujo de trabajo integradas para casos de uso comunes:

Configuración

Compatibilidad del cliente

Desarrollo

git clone https://github.com/charlesrapp/pruna-mcp-server.git
cd pruna-mcp-server
uv sync --extra dev

# Run tests (100 tests, 94% coverage)
uv run pytest --cov

# Lint & type check
uv run ruff check src/ tests/
uv run mypy src/

Consulta CONTRIBUTING.md para ver las directrices.

Licencia

MIT: consulta LICENSE.