Meshy MCP Server

Meshy MCP服务器

模型上下文协议（MCP） 服务器 网格AI 3D生成平台。使AI代理能够通过自然对话创建、管理和下载3D模型、纹理、图像、操纵角色和动画。

特性

涵盖整个Meshy API的20个工具：

关键能力

• 文本转换为3D：从文本描述生成3D模型（预览+优化管道）
• 图像到3D：将单个或多个图像转换为3D模型
• 汽车装配与动画：为人形角色添加骨架和动画
• 3D打印套件（v0.3.0）:

- analyze_printability --自由FDM检查（水密性、体积、孔、非歧管边缘、退化面） - repair_printability --10学分拓扑修复（输出格式反映输入） - process_multicolor --适用于AMS/MMU打印机的10学分多色3MF

• 切片器集成：自动检测7个已安装的切片器（OrcaSlicer、Bambu、Creality、Elegoo、Anycubic、PrusaSlicer、Cura），并返回代理可以执行的启动命令
• 智能文件组织：自动保存到 meshy_output/ 具有项目文件夹、元数据和历史跟踪功能
• 内置工作流智能：服务器说明指导代理完成每个用例的正确工具链

先决条件

• Node.js>=18
• 一个Meshy API密钥(在这里买一个 --需要Pro计划或更高版本）

安装

选择适合您工作流程的选项——它们都会生成相同的配置。

选项1·单命令安装·推荐

add-mcp 自动检测机器上的每个AI客户端（Cursor、Claude Code、Claude Desktop、Windsurf、Codex、VS Code、Cline等），并为每个客户端写入正确的配置：

npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

完成后，跳到 激活 为您的客户。

选项2·通过询问您的AI代理进行安装

已经在和Cursor/Claude Code/Code聊天了吗？粘贴此提示：

Install the Meshy MCP server for me. Docs: https://github.com/meshy-dev/meshy-mcp-server
Use this env var: MESHY_API_KEY=msy_YOUR_API_KEY

代理将运行 add-mcp （或写 mcp.json 直接），并告诉你什么时候准备好了。你仍然需要 激活 为你的客户迈出一步。

选项3·手动安装

Cursor

粘贴到 .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "meshy": {
      "command": "npx",
      "args": ["-y", "@meshy-ai/meshy-mcp-server"],
      "env": { "MESHY_API_KEY": "msy_YOUR_API_KEY" }
    }
  }
}

视窗：替换 "command": "npx" 随着 "command": "cmd" 和 "args": ["/c", "npx", "-y", "@meshy-ai/meshy-mcp-server"].

Claude Code

claude mcp add-json meshy '{"command":"npx","args":["-y","@meshy-ai/meshy-mcp-server"],"env":{"MESHY_API_KEY":"msy_YOUR_API_KEY"}}'

Other clients (Windsurf, Claude Desktop, Codex, VS Code, Cline…)

使用 选项1 — add-mcp 为每个对象写入正确的配置。

安装后激活

大多数客户端会自动加载新服务器，但是 光标和VS代码需要手动切换:

故障排除

• MESHY_API_KEY environment variable is required --密钥未到达服务器。确保它位于一个 "env": {...} 阻塞在你的 mcp.json，不在 args.
• spawn npx ENOENT （Windows）--用 cmd /c （见上面的光标块）。
• error: unknown option '-y' （Windows上的Claude代码）--使用 claude mcp add-json 而不是 claude mcp add … -- npx -y ….
• 光标未列出 meshy --确保 mcp.json 是有效的JSON（没有尾随逗号），然后完全重新启动Cursor。
• 工具调用返回401 -API密钥无效或已被吊销。在以下时间重新生成https://www.meshy.ai/settings/api.

配置

发展

# Clone and install
git clone https://github.com/meshy-dev/meshy-mcp-server.git
cd meshy-mcp-server
npm install

# Development with hot reload
npm run dev

# Build
npm run build

# Type check
npm run lint

# Run
npm start

HTTP传输

对于远程访问，请在HTTP模式下运行：

TRANSPORT=http PORT=3000 npm start

终点：

• POST /mcp --MCP协议端点
• GET /health --健康检查

许可证

麻省理工学院