lowpoly 将于 2026年10月30日 下线。 请在这些日期前切换模型，以免请求报错。 查看所有弃用信息

AI 集成

通过 Meshy MCP server 进行工具调用，或者使用 llms.txt 和 llms-full.txt 来阅读文档，从而将 AI 代理和编码助手连接到 Meshy。

如果你使用 Claude Code、Cursor、Windsurf、Codex 或其他 MCP 客户端，请安装 MCP server。如果你的聊天代理不支持 MCP，可以改为将其指向 https://docs.meshy.ai/llms.txt。

什么是 MCP

Model Context Protocol (MCP) 是一个开放标准，让 AI 助手能够调用外部工具并获取结构化上下文。Meshy MCP server 将 Meshy REST API 封装为代理可以调用的工具。有了这些工具，代理无需手写 HTTP 代码即可生成模型、检查任务状态并下载结果。

MCP server 是开源的。它以 @meshy-ai/meshy-mcp-server 的形式发布在 npm 上，其源代码位于 GitHub 上的 meshy-mcp-server 仓库中。

你需要一个 Meshy API key。可以在开发者平台的 API Keys 页面上创建一个。MCP server 会从 MESHY_API_KEY 环境变量中读取它。

安装 MCP server

要安装 server，请使用与你的 AI 客户端对应的选项卡。将 msy_YOUR_API_KEY 替换为你的 API key。

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

更喜欢使用 skill？开源的 meshy-3d-agent skill 包为 Claude Code、Cursor 和 OpenClaw 提供了现成的 Meshy 工作流，例如生成模型、轮询任务以及下载结果。它直接调用 Meshy REST API，因此你不需要 MCP server。

npx skills add meshy-dev/meshy-3d-agent

可用工具

MCP server 将 Meshy REST API 以下列工具的形式提供，并按功能进行了分组。

3D 生成

  • meshy_text_to_3d：根据文本 prompt 创建未上贴图的预览 mesh
  • meshy_image_to_3d：根据单张图片创建 3D 模型
  • meshy_multi_image_to_3d：根据同一物体的多张图片创建 3D 模型
  • meshy_text_to_3d_refine：为预览 mesh 添加 texture

后处理

  • meshy_remesh：更改现有模型的 topology 或 polycount，或两者同时更改
  • meshy_retexture：为现有模型应用新的 texture
  • meshy_rig：为 3D 人形角色添加骨骼
  • meshy_animate：为已添加骨骼的角色应用 Animation
  • meshy_convert：将模型转换为另一种文件格式
  • meshy_resize：将模型调整为真实世界的尺寸
  • meshy_uv_unwrap：为模型生成新的 UV 布局
  • meshy_text_to_motion：根据文本 prompt 生成 Animation
  • meshy_list_animations：免费查询预设 Animation 动作的 ID

Creative Lab

  • meshy_creative_lab：将照片转换为完成的 Creative Lab 产品（会运行 prototype 和 build 任务）

图像生成

  • meshy_text_to_image：根据文本创建 2D 图像
  • meshy_image_to_image：根据参考图像创建 2D 图像

任务管理

  • meshy_get_task_status：检查任务状态并获取下载链接
  • meshy_list_tasks：列出最近的任务，可按类型或状态筛选
  • meshy_cancel_task：删除任务。对于 PENDING 任务，Meshy 会将其移除并退款；对于已完成的任务，则会将其删除。IN_PROGRESS 状态的任务无法取消，API 会返回 409。
  • meshy_download_model：下载已完成的模型文件并保存到本地

Workspace

  • meshy_list_models：列出你最近的 Text to 3D 模型。对于其他任务类型，请使用 meshy_list_tasks。

3D 打印

  • meshy_send_to_slicer：查找你电脑上已安装的切片软件，并返回一条可在其中打开模型的命令。该操作在本地运行，不会调用 Meshy API。
  • meshy_analyze_printability：免费检查模型的 FDM printability，包括水密性、体积、孔洞、非流形边和退化面
  • meshy_process_multicolor：将带 texture 的模型转换为用于打印的多色 3MF 文件
  • meshy_repair_printability：修复模型以用于 FDM 打印
  • meshy_auto_split：将模型拆分为可单独打印的部件

账户

  • meshy_check_balance：查询你剩余的积分
  • meshy_list_usage：列出你团队已完成的 API 任务及每个任务消耗的积分，适用于 Studio 和 Enterprise 团队

工具名称及其行为可能会发生变化。完整列表请参阅 MCP server 源代码中的工具。

示例 prompt

首先，可以在支持 MCP 的聊天中尝试以下 prompt：

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.

Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.

What's my current Meshy credit balance?

List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt 与 llms-full.txt

如果你的代理不支持 MCP，或者你想直接将 Meshy 文档放入 prompt 中，可以将其指向文档的纯文本版本：

  • llms.txt：一份精简的索引，包含集成说明，例如如何轮询异步任务、authentication、速率限制、模型选择，以及常见错误。
  • llms-full.txt：一个文件中包含所有 API 页面，方便代理通过一次请求读取全部文档。
  • 逐页 Markdown：在任意 endpoint URL 后加上 .md，例如 https://docs.meshy.ai/api/text-to-3d.md。

每次文档站点构建时，Meshy 都会重新生成这三个文件，以确保它们与 HTML 文档保持一致。

常见问题

MCP server 是无状态的吗？
它不会存储你的凭据。server 仅将 MESHY_API_KEY 保存在内存中，从不写入磁盘。默认情况下，它会将下载的模型及其元数据保存在其工作目录下的 meshy_output 文件夹中。若要将下载内容保存到其他位置，可为下载工具提供一个 save_to 路径。
MCP 的费用与 REST API 相同吗？
是的。MCP 工具调用执行的是相同的 REST 调用，并按相同费率消耗积分。各项具体价格请参阅 Pricing 页面。
速率限制是多少？
MCP server 的调用会计入与你的 REST API 调用相同的速率限制。各套餐的限制请参阅速率限制页面。
MCP server 可以访问哪些 Meshy 数据？
仅限于你的 MESHY_API_KEY 通过 REST API 能够访问的内容，且权限相同。
如何报告问题？
请在 GitHub 上的 meshy-mcp-server 仓库中提交 issue：https://github.com/meshy-dev/meshy-mcp-server/issues