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 — 从文本提示词生成 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 服务器源代码。

示例提示词

将这些示例粘贴到你的 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 调用,按完全相同的速率消耗积分。完整矩阵请参阅 Pricing。

速率限制是多少?

MCP 服务器与 REST API 共享相同的速率限制层级。各级别限制请参阅 Rate Limits。

MCP 可以访问什么 Meshy 数据?

仅限 MESHY_API_KEY 通过 REST 可访问的内容。权限范围与 REST 完全一致。

如何报告问题?

在 github.com/meshy-dev/meshy-mcp-server 提交 issue。