Meshy AI MCP Server

Meshy AI MCP 服务

这是一个 Model Context Protocol（MCP）服务，用于封装 Meshy AI API。它使 MCP 客户端（如 Claude Desktop、Cursor、Cline）能够直接使用 Meshy 的生成式 3D 工具。

功能

• 文本转 3D：根据文本提示词生成 3D 模型。
• 图像转 3D：根据参考图像创建 3D 模型。
• 多图转 3D：根据多张参考图像创建 3D 模型。
• 重新纹理：为现有 3D 模型应用新纹理。文本转纹理工具是同一重新纹理 API 的兼容别名。
• 文本转图像：根据文本提示词生成图像。
• 图像转图像：根据输入图像生成新图像。
• 模型优化：重新网格化并优化几何结构。
• 绑定骨骼：为 3D 角色自动绑定骨骼，以便进行动画制作。
• 动画：为已绑定骨骼的角色应用动画。
• 流式传输：为长时间运行的任务提供实时进度更新。
• 删除任务：删除所有 API 类别中的任务。

安装

选项 1：使用 npx 直接运行（推荐）

你可以使用 npx 直接运行服务，无需全局安装。

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

选项 2：克隆并在本地构建

如果你想修改代码或从本地源代码运行：

1. 克隆代码库：

   git clone <repository-url>
   cd meshy-ai-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 配置 MCP 客户端：

   将以下内容添加到 MCP 客户端配置中（例如 claude_desktop_config.json 或 VS Code 设置）：

   {
     "mcpServers": {
       "meshy-ai": {
         "command": "node",
         "args": [
           "/absolute/path/to/meshy-ai-mcp-server/dist/index.js"
         ],
         "env": {
           "MESHY_API_KEY": "your_meshy_api_key_here"
         }
       }
     }
   }
   

配置

使用此服务需要 Meshy AI API 密钥。

1. 从 Meshy Dashboard 获取 API 密钥。
2. 在 MCP 客户端配置中设置 MESHY_API_KEY 环境变量（如上所示）。

可选环境变量

• MESHY_API_BASE：覆盖 API 基础 URL（默认值：https://api.meshy.ai/openapi）。
• MESHY_STREAM_TIMEOUT_MS：流式响应的超时时间，单位为毫秒（默认值：300000，即 5 分钟）。

故障排除

如果 MCP 客户端报告服务在 initialize 期间关闭，请检查客户端配置是否将 MESHY_API_KEY 传递给服务进程。服务可以在没有密钥的情况下启动，以便客户端检查可用工具，但在配置密钥之前，Meshy API 工具调用会失败。

开发

如需在开发模式下运行服务并启用自动重新加载：

# Create a .env file
echo "MESHY_API_KEY=your_key_here" > .env

# Run in dev mode
npm run dev

可用工具

• 文本转 3D：create_text_to_3d_task、retrieve_text_to_3d_task、list_text_to_3d_tasks、stream_text_to_3d_task、delete_text_to_3d_task
• 图像转 3D：create_image_to_3d_task、retrieve_image_to_3d_task、list_image_to_3d_tasks、stream_image_to_3d_task、delete_image_to_3d_task
• 多图像转 3D：create_multi_image_to_3d_task、retrieve_multi_image_to_3d_task、list_multi_image_to_3d_tasks、stream_multi_image_to_3d_task、delete_multi_image_to_3d_task
• 重新纹理：create_retexture_task、retrieve_retexture_task、list_retexture_tasks、stream_retexture_task、delete_retexture_task
• 纹理处理（重新纹理别名）：create_text_to_texture_task、retrieve_text_to_texture_task、list_text_to_texture_tasks、stream_text_to_texture_task、delete_text_to_texture_task — 使用相同的重新纹理 API，为保持兼容性而保留历史工具名称。
• 文本转图像：create_text_to_image_task、retrieve_text_to_image_task、list_text_to_image_tasks、stream_text_to_image_task、delete_text_to_image_task
• 图像转图像：create_image_to_image_task、retrieve_image_to_image_task、list_image_to_image_tasks、stream_image_to_image_task、delete_image_to_image_task
• 重新网格化：create_remesh_task、retrieve_remesh_task、list_remesh_tasks、stream_remesh_task、delete_remesh_task
• 绑定骨骼：create_rigging_task、retrieve_rigging_task、list_rigging_tasks、stream_rigging_task、delete_rigging_task
• 动画：create_animation_task、retrieve_animation_task、list_animation_tasks、stream_animation_task、delete_animation_task
• 实用工具：get_balance

许可证

MIT