PicoBerry MCP 服务器被描述为一个面向游戏、VR 及其他领域的 AI 3D 工作区。它的核心目标是在任何 MCP 客户端中生成、重网格化、纹理化和动画化 3D 资产，实现“多引擎、一个 API”。
用途 该工具面向游戏与 3D 工作流，可在 MCP 客户端（如 Claude Code、Cursor、Claude Desktop、Cline）中直接生成 3D 模型、图像和动画，无需编写 HTTP 胶水代码。它是 PicoBerry /v1 API 的轻量封装，使 PicoBerry 的多引擎管线可直接在代理（agent）内部使用。
主要能力 支持从文字提示生成 3D 模型（如示例中“生成一个低多边形宝箱，重拓扑到 3k 三角面，并给我 Unity FBX”），也支持从参考图片出发。生成之后可执行重网格化、重纹理、自动绑定骨骼和动画制作，并导出为 GLB、FBX、OBJ 等格式。多个 3D 与图像引擎位于同一个 API 之后，可调用 list_models 获取实时引擎集合及每个引擎的成本。生成资源被定位为草稿，适合原型制作与迭代，并可针对项目进行审查或精修。
使用方式 无需安装，可直接用 npx 运行。在 Cursor 中，使用相同的配置结构写入 ~/.cursor/mcp.json。需要先在 https://picoberry.ai 注册并登录，打开仪表板中的 API Keys 选项卡，点击“Create key”。密钥仅显示一次，需立即复制并像密码一样保管。API 访问需要完成购买（订阅或一次性点数包），购买后即可永久获得授权，无需保持当前订阅。使用 API 需要完成购买，详见“Get an API key”。MCP 或 API 没有单独订阅；生成消耗的预付费 PicoBerry 点数与网页应用相同，按引擎计费，可在花费前通过 list_models 查看费率。
生成流程（异步）
- 调用 generate_3d_from_text({ prompt }) → 返回资产 { id }。
- 调用 wait_for_asset({ asset_id: id }) → 轮询直到 taskStatus === 2（成功）。
- 从 files.model（GLB）或 files.image（PNG）读取结果 URL。 其中 taskStatus：0 待处理、1 处理中、2 成功、3 失败。结果 URL 是签名且短时效的，需及时下载。错误返回时会附带可操作的信息（例如未知引擎会返回有效名称列表）。
与 Blender MCP 配合 可与 blender-mcp 一同运行，使代理先用 PicoBerry 生成，再在一个流程中导入 Blender。
发布相关（代码贡献者参考） 运行 Actions → Publish → Run workflow（或推送 v* 标签），会先发布到 npm，再发布到官方 MCP 注册表，顺序不能颠倒，因为注册表会通过抓取包的 npm 元数据并将 mcpName 与 server.json 的 name 进行匹配来校验，所以 npm 必须先完成。发布前有一个守卫步骤检查所有不变量（名称/版本一致性、命名空间大小写、版本未在 npm 上存在），因为 npm 版本不可变，一次失败的半发布就会消耗掉该版本号。需同时在 package.json 和 server.json 中提升版本（version 和 packages[0].version），若两者不一致守卫会使运行失败。一次性设置无需密钥：两次发布都通过工作流的 GitHub OIDC 令牌（id-token: write）认证，无需存储或轮换任何内容。仅需在 npmjs.com 上让 npm 信任该工作流：进入 @picoberry/mcp-server → Settings → Trusted publishing → GitHub Actions 并输入对应信息；工作流文件名必须完全匹配，因为它是 npm 验证的一部分。MCP 注册表无需任何设置：mcp-publisher 交换 Actions OIDC 令牌，注册表根据令牌的 repository_owner 声明授予 io.github.<repository_owner>/*，涵盖 io.github.UModeler/picoberry-mcp，并避免需要组织 Owner 的交互式浏览器登录。Trusted Publishing 需要 npm >= 11.5.1，因此工作流运行在 Node 24（npm 11.x）；Node 22 仍捆绑 npm 10.9 会失败，node-version 锁定至关重要。命名空间按字节精确比较：io.github.UModeler/... 与 GitHub 组织的登录名匹配，小写的 io.github.umodeler/... 会被 403 拒绝。发布后，认领 Glama 列表——未认领的服务器可发现性有限，且 awesome-mcp-servers 在 CI 中以 Glama 徽章作为其 PR 的门槛。
限制 生成的资产为草稿，适合原型与迭代。API 需要完成购买。结果 URL 是签名且短时效的，需及时下载。环境变量等细节资料中未提供具体值。
