快速开始

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 模型、图像和动画。它是对相同端点的轻量封装，已作为 @picoberry/mcp-server 发布到 npm（源码，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 只需一条命令即可添加：

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单个资产的状态和结果 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。