AI 整合

Meshy 為 AI 代理程式和程式設計助手提供兩種接入管道：Meshy MCP 伺服器（用於工具呼叫）和 llms.txt / llms-full.txt（用於文件擷取）。

如果你正在使用 Claude Code、Cursor、Windsurf、Codex 或其他 MCP 相容工具整合 Meshy，請安裝下方的 MCP 伺服器。如果你使用的是不支援 MCP 的一般聊天代理程式，請將其指向 https://docs.meshy.ai/llms.txt。

什麼是 MCP

Model Context Protocol (MCP) 是一個開放標準，讓 AI 助手可以呼叫外部工具並取得結構化上下文。Meshy MCP 伺服器將 Meshy REST API 封裝成一組工具，供你的代理程式呼叫——生成模型、檢查任務、下載結果——不需要手寫 HTTP 程式碼。

MCP 伺服器為開源，並發布於 npm，套件名稱為 @meshy-ai/meshy-mcp-server。原始碼：github.com/meshy-dev/meshy-mcp-server。

你需要一組 Meshy API 金鑰。請在 https://www.meshy.ai/settings/api 建立。MCP 伺服器會從 MESHY_API_KEY 環境變數讀取。

快速安裝

# 自动检测已安装的 AI 客户端并为每个配置 Meshy
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

想要不必安裝 MCP 就能即插即用的技能包嗎？ 開源的 meshy-3d-agent 技能包為 Claude Code、Cursor 和 OpenClaw 預先設定了 Meshy 工作流程（生成 → 輪詢 → 下載）。它會直接呼叫 Meshy REST API，不需要 MCP 伺服器。

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

可用工具

MCP 伺服器會依功能將 Meshy REST API 暴露為工具。

3D 生成

  • meshy_text_to_3d — 從文字 prompt 生成 3D 模型
  • meshy_image_to_3d — 從單張圖片生成 3D 模型
  • meshy_multi_image_to_3d — 從同一物件的多張圖片生成 3D 模型
  • meshy_text_to_3d_refine — 為預覽網格加上貼圖

後處理

  • meshy_remesh — 變更現有模型的拓撲和/或多邊形數
  • meshy_retexture — 為現有模型套用新貼圖
  • meshy_rig — 為 3D 人形角色新增骨骼
  • meshy_animate — 為已完成骨骼綁定的角色套用動畫

圖片生成

  • meshy_text_to_image — 從文字生成 2D 圖片
  • meshy_image_to_image — 從參考圖片生成 2D 圖片

任務管理

  • meshy_get_task_status — 檢查任務狀態和下載 URL
  • meshy_list_tasks — 列出近期任務，可依類型/狀態篩選
  • meshy_cancel_task — 取消待處理或進行中的任務
  • meshy_download_model — 取得已完成的模型檔案並儲存到本機

工作區

  • meshy_list_models — 列出已驗證使用者工作區中的所有模型

3D 列印

  • meshy_send_to_slicer — 偵測本機已安裝的切片軟體並在其中開啟模型（於本機執行，不呼叫 Meshy API）
  • meshy_analyze_printability — 目前會回傳手動列印就緒檢查清單（壁厚、懸垂、流形網格等）。待 Meshy 可列印性 API 上線後將升級為自動分析。
  • meshy_process_multicolor — 將帶有貼圖的模型轉換為多色 3MF 檔案以供列印

帳戶

  • meshy_check_balance — 查詢剩餘點數

工具名稱和行為可能會演進。權威清單請參閱 MCP 伺服器原始碼。

範例 prompt

將這些範例貼到你已啟用 MCP 的聊天中作為起點。

从提示词 "a cartoon fox sitting" 生成一个 3D 狐狸模型,预览它,
然后使用 PBR 贴图为其添加纹理。将最终的 GLB 下载到 ./outputs。

获取 https://example.com/sculpture.jpg 的图像并将其转换为可绑定骨骼的
3D 角色。使用 `should_remesh: true` 和 50k 目标多边形数。

我当前的 Meshy 积分余额是多少?

列出我最近 10 个成功的 text-to-3d 任务,并将前 3 个作为 GLB 下载到 ./downloads/。

llms.txt 與 llms-full.txt

如果你的代理程式不支援 MCP，或者你想直接將 Meshy 文件擷取到 prompt 中，請將其指向我們的純文字介面：

  • llms.txt — 精簡索引 + 整合說明（正確的非同步輪詢模式、驗證規則、速率限制、模型選擇、常見錯誤）。
  • llms-full.txt — 所有 API 頁面串接在單一檔案中，供一次取得並擷取。
  • 逐頁 Markdown：在任何端點 URL 後附加 .md。範例：https://docs.meshy.ai/api/text-to-3d.md。

這三個檔案都會在文件網站建置時重新生成，因此永遠不會與 HTML 文件產生落差。

常見問題

MCP 伺服器是無狀態的嗎？
是的。你的 MESHY_API_KEY 會依請求使用，伺服器端不會持久化保存。
MCP 與 REST API 的費用相同嗎？
是的——每次 MCP 工具呼叫都對應一次 REST 呼叫，並以完全相同的速率消耗點數。完整矩陣請參閱價格頁面。
速率限制是多少？
MCP 伺服器與 REST API 共用相同的速率限制層級。各層級限制請參閱 Rate Limits 頁面。
MCP 可以存取哪些 Meshy 資料？
僅限 MESHY_API_KEY 可透過 REST 存取的內容。權限範圍與 REST 完全一致。
如何回報問題？
請在 meshy-mcp-server 儲存庫提交 issue: https://github.com/meshy-dev/meshy-mcp-server/issues