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