🎨 pruna-mcp-server

MCP-сервер для Pruna AI — сверхбыстрая генерация, редактирование, апскейлинг изображений и создание видео прямо из вашего ИИ-ассистента.

Pruna AI — это API для инференса, специализирующееся на генерации изображений и видео. Оно предлагает генерацию изображений менее чем за 2 секунды по цене от $0.005 за изображение, включая модели для преобразования текста в изображение, редактирования изображений, апскейлинга и генерации видео. Этот MCP-сервер является оберткой для их API, позволяя любому MCP-совместимому клиенту (Claude Desktop, Kiro, Cursor) создавать визуальный контент нативно.

Соответствует спецификации MCP 2025-11-25.

Функции

• 6 инструментов MCP: generate_image, edit_image, upscale_image, generate_video, list_models, upload_file

• 7 промптов MCP: Фотографии товаров, виртуальный стейджинг, визуальные материалы для соцсетей, концепт-арт для игр, рекламные креативы, видеореклама, улучшение изображений

• 2 ресурса MCP: каталог pruna://models для поиска моделей без вызова инструментов

• 18 моделей: 10 для текста в изображение, 3 для редактирования, 1 для апскейлинга, 4 для видео

• Умная синхронизация/асинхронность: Синхронная работа для быстрых моделей изображений, асинхронная с опросом для видео

• Прозрачная обработка файлов: Передавайте локальные пути или URL — автоматическая загрузка включена

• Нативный возврат изображений MCP: Блоки ImageContent для клиентов, поддерживающих встроенное отображение

• Полная совместимость с MCP: Аннотации инструментов, структурированный контент, уведомления о прогрессе

Быстрый старт

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

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

Установите свой API-ключ — получите его на pruna.ai (перейдите на портал разработчика или свяжитесь с Pruna, чтобы запросить доступ):

# 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"

Конфигурация MCP-клиента

Kiro CLI

Добавьте в конфигурацию агента (например, ~/.kiro/agents/default.json):

В 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"]
}

В tools добавьте: "@pruna/*"

В allowedTools добавьте: "generate_image", "edit_image", "upscale_image", "generate_video", "list_models", "upload_file"

Примечание: Агенты Kiro используют белый список tools с синтаксисом @server-name/* и список allowedTools. Оба должны включать инструменты Pruna, чтобы они были доступны.

Claude Desktop

Добавьте в ~/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"]
    }
  }
}

Важно: Используйте полный путь к uv (например, /Users/you/.local/bin/uv) — Claude Desktop запускает процессы с минимальным PATH, который не включает ~/.local/bin.

Примечание: Claude Desktop не отображает ImageContent внутри чата. Изображение генерируется и сохраняется локально — Claude укажет путь к файлу в своем ответе.

Cursor

Добавьте в .cursor/mcp.json:

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

Инструменты

Инструменты для работы с изображениями возвращают как блок метаданных JSON, так и нативный блок MCP ImageContent (base64, для изображений < 5 МБ).

Промпты

Встроенные шаблоны рабочих процессов для типичных задач:

Конфигурация

Совместимость с клиентами

Разработка

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/

См. CONTRIBUTING.md для получения руководств.

Лицензия

MIT — см. LICENSE.