はじめに

MCP サーバー

npx -y @picoberry/mcp-server

すでにお使いのどんな AI エージェントでも、PicoBerry の生成をネイティブツールとして使えます。Claude Code と Desktop、Cursor、VS Code(Copilot)、Windsurf、Zed、OpenAI Codex、Gemini、Cline、その他あらゆる MCP クライアントに対応。HTTP の接続コードは不要です。

PicoBerry MCP サーバーは /v1 API を Model Context Protocol ツールとして公開するため、AI アシスタントが 3Dモデル・画像・アニメーションを直接生成できます。同じエンドポイントをラップした薄いラッパーで、npm に @picoberry/mcp-server として公開されています(ソース、MIT)。

REST API と同じキー MCP サーバーは pb_live_ キーを使用します。API アクセスは、購入を完了したすべてのアカウント(サブスクリプションまたは単発のクレジットパック)、または有効な有料サブスクリプションをお持ちのアカウントでご利用いただけます。認証を参照してください。

インストール

インストールは不要です。npx が初回実行時に取得します。MCP クライアントの設定に追加してから、クライアントを再起動してください。設定ファイル:Claude Code .mcp.json・Claude Desktop claude_desktop_config.json・Cursor ~/.cursor/mcp.json。

mcp 設定
{
  "mcpServers": {
    "picoberry": {
      "command": "npx",
      "args": ["-y", "@picoberry/mcp-server"],
      "env": {
        "PICOBERRY_API_KEY": "pb_live_xxxxxxxxxxxx",
        "PICOBERRY_API_BASE": "https://api.picoberry.ai"
      }
    }
  }
}

Codex CLI はコマンド 1 つで追加できます:

codex cli
codex mcp add picoberry -- npx -y @picoberry/mcp-server

環境変数

変数説明
PICOBERRY_API_KEY必須
string		pb_live_ キー。ダッシュボードの プロフィール → API キー で作成します。
PICOBERRY_API_BASE
string		API のベース URL。デフォルトは https://api.picoberry.ai です。

ツール

生成は REST API と同様に非同期です。generate_*(または後処理)の呼び出しがアセットの id を返すので、成功するまで wait_for_asset を呼び出す(または get_asset をポーリングする)と、出力 URL を読み取れます。

ツール用途
list_modelsカテゴリ(3d/image/remesh/texture/animate)ごとのエンジン/モデルとクレジット消費量。エンジンをハードコードする代わりにこれを呼び出してください。
list_animation_presetsanimate 用のアニメーションプリセット id(エンジンごと)。
get_credits現在のクレジット残高とプラン。
generate_imageテキスト → 画像(任意で参照画像 URL を指定)。
generate_3d_from_textテキスト → 3Dモデル(GLB)。
generate_3d_from_image画像 → 3Dモデル。単一画像または 2〜4枚のビュー(マルチビュー)。公開 URL またはローカルファイルパス。
remesh既存の 3D アセットをリトポロジーします。
texture既存の 3D アセットをリテクスチャ(PBR)します。
animate既存の 3D キャラクターをオートリグしてアニメーション化します。
get_assetアセット 1 つの状態と結果 URL。
wait_for_assetアセットが完了(またはタイムアウト)するまでポーリングして返します。
list_my_assets生成したアセットを一覧します。
download_asset完了した 3D アセット(glb/fbx/obj)をエクスポートします → 署名付き URL。

例

アシスタントにこう頼みます:「ローポリの宝箱を作って、3kトライアングルにリトポロジーして、Unity ですぐ使える FBX をちょうだい。」 するとツールを次のように連鎖させます:

tool calls
list_models(category="3d")                                      → pick an engine
generate_3d_from_text(prompt="low-poly treasure chest")         → { id: A }
wait_for_asset(asset_id=A)                                       → succeeded
remesh(asset_id=A, polycount=3000)                              → { id: B }
wait_for_asset(asset_id=B)
download_asset(asset_id=B, format="fbx", texture_preset="unity") → signed URL

Blender と併用する

blender-mcp と並べて実行してください。サーバーは別々なので、アシスタントが PicoBerry で生成し、一つの流れの中で Blender にインポートできます:

mcp 設定
{
  "mcpServers": {
    "picoberry": { "command": "npx", "args": ["-y", "@picoberry/mcp-server"] },
    "blender":   { "command": "uvx", "args": ["blender-mcp"] }
  }
}
薄いラッパー すべてのツールは /v1 呼び出しにマッピングされます。同じクレジット・レート制限・モデレーションが適用されます。ツールの全リファレンスと更新情報は README にあります。