pruna

🎨 pruna-mcp-server

Pruna AI の MCP サーバーです。AI アシスタントから直接、超高速の画像生成、編集、アップスケーリング、動画生成を行えます。

Pruna AI は、画像と動画の生成に特化した推論 API です。画像 1 枚あたり $0.005 から、2 秒未満で画像を生成でき、テキストからの画像生成、画像編集、アップスケーリング、動画生成に対応するモデルを提供しています。この MCP サーバーは同社の API をラップし、MCP 互換クライアント（Claude Desktop、Kiro、Cursor）でビジュアルコンテンツをネイティブに生成できるようにします。

MCP Specification 2025-11-25 に準拠しています。

機能

• 8 個の MCP ツール：generate_image、edit_image、try_on_image、upscale_image、generate_video、transform_video、list_models、upload_file
• 7 個の MCP プロンプト：商品写真、バーチャルステージング、ソーシャルメディア用ビジュアル、ゲームのコンセプトアート、広告クリエイティブ、動画広告、画像の補正
• 2 個の MCP リソース：ツールを呼び出さずにモデルを検索できる pruna://models カタログ
• 21 個のモデル：テキストからの画像生成 10 個、編集 3 個、バーチャル試着 1 個、アップスケーリング 1 個、動画 4 個、動画から動画への変換 2 個
• スマートな同期／非同期処理：高速な画像モデルには同期処理、動画にはポーリングを伴う非同期処理を使用
• 透過的なファイル処理：ローカルパスまたは 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"

# Linux (GNOME Keyring)
secret-tool store --label="Pruna API Key" service pruna-mcp-server key api_key <<< "your-api-key"

# Windows (PowerShell)
[System.Environment]::SetEnvironmentVariable("PRUNA_API_KEY", "your-api-key", "User")

# Or environment variable (all platforms)
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", "try_on_image", "upscale_image", "generate_video", "transform_video", "list_models", "upload_file"]
}

tools に "@pruna/*" を追加します。

allowedTools に "generate_image", "edit_image", "try_on_image", "upscale_image", "generate_video", "transform_video", "list_models", "upload_file" を追加します。

注：Kiro エージェントでは、@server-name/* 構文を使った tools の許可リストと、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 は ~/.local/bin を含まない最小限の PATH でプロセスを起動します。

注：Claude Desktop はチャット内に ImageContent をインライン表示しません。画像は生成されてローカルに保存され、Claude の応答でファイルパスが参照されます。

Cursor

.cursor/mcp.json に追加します。

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

ツール

ツール	説明	料金
generate_image	10 種類のモデルによるテキストから画像への生成	1 画像あたり $0.0001 から
edit_image	テキストの指示で 1～5 枚の画像を編集	1 画像あたり $0.010 から
try_on_image	バーチャル試着：人物に最大 11 点の衣服を着せます	最初の 1 点は $0.015、追加の衣服 1 点ごとに $0.008
upscale_image	最大 1 億 2,800 万画素までの AI アップスケーリング	1 画像あたり $0.005 から
generate_video	テキスト／画像／音声から動画を生成	1 秒あたり $0.005 から
transform_video	動画から動画への変換：被写体をアニメーション化、またはキャラクターを置き換えます	720p は 1 秒あたり $0.03、1080p は 1 秒あたり $0.06
list_models	料金とともに利用可能なすべてのモデルを確認	無料
upload_file	編集／動画ワークフロー用のファイルをアップロード	無料

画像ツールは、JSON メタデータブロックとネイティブ MCP ImageContent ブロック（5 MB 未満の画像の場合は base64）の両方を返します。

動画ツールは、JSON メタデータブロック（Pruna の配信 URL への download_url を含む）、ネイティブ MCP バイナリーリソースとしての .mp4（25 MB 未満の動画の場合は EmbeddedResource blob。クライアントは画像を保存するときと同じ方法でファイルを保存します）、および大きなファイルのフォールバックとして同じ配信 URL を指す ResourceLink を返します。すべてのツールは絶対パスの file_path を返します。

プロンプト

一般的なユースケース向けの組み込みワークフローテンプレート：

プロンプト	ユースケース	例
product-photo	E コマース商品の写真	「すっきりした背景に置かれた白いレザーのスニーカー」
virtual-staging	不動産の部屋のステージング	空室に家具を配置
social-media-visual	プラットフォームに最適化されたビジュアル	プラットフォームごとのアスペクト比を自動設定
game-concept-art	ゲームのアセットと環境	キャラクター、武器、風景
ad-creative	テキストオーバーレイ付きデジタル広告	画像内に見出しを描画
video-ad	短い動画広告	トークヘッド、商品デモ
image-enhance	アップスケール＋高画質化のワークフロー	AI 生成画像の調整

設定

環境変数	必須	デフォルト	説明
PRUNA_API_KEY	✅	—	お使いの Pruna AI API キー
PRUNA_OUTPUT_DIR	—	~/pruna-output	ダウンロードしたファイルの保存ディレクトリ
PRUNA_POLL_INTERVAL	—	2	非同期ポーリングの間隔（秒）
PRUNA_TIMEOUT	—	120	HTTP タイムアウト（秒）
PRUNA_MAX_RETRIES	—	3	一時的なエラーが発生した場合の最大再試行回数

クライアントの互換性

クライアント	トランスポート	ステータス	備考
Kiro CLI	STDIO	✅ テスト済み	tools + allowedTools の設定が必要です
Claude Desktop	STDIO	✅ テスト済み	uv のフルパスを指定してください。インラインでの画像表示には対応していません
Cursor	STDIO	🔲 予定	—
Claude Code	STDIO	🔲 予定	—

開発

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

# Run tests (147 tests, 97% coverage)
uv run pytest --cov

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

ガイドラインについては、CONTRIBUTING.md をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。