Meshy AI MCP Server

这是一个Model Context Protocol (MCP) 服务器，封装了Meshy AI API。它使MCP客户端（如Claude Desktop、Cursor、Cline）能够直接与Meshy的生成式3D工具进行交互。

功能

• 文本到3D：从文本提示生成3D模型。
• 图像到3D：从参考图像创建3D模型。
• 文本到纹理：使用文本提示为现有模型应用纹理。
• 模型优化：重新网格化并优化几何形状。
• 骨骼绑定：自动为动画绑定3D角色。
• 动画：为已绑定的角色应用动画。
• 流媒体：长时间运行任务的实时进度更新。

安装

方案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仪表板获取您的API密钥。
2. 在您的MCP客户端配置中设置MESHY_API_KEY环境变量（如上所示）。

可选环境变量

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

开发

要在开发模式下运行服务器，并启用自动重载：

# 创建一个.env文件
echo "MESHY_API_KEY=your_key_here" > .env

# 在开发模式下运行
npm run dev

可用工具

• 文本到3D：create_text_to_3d_task，retrieve_text_to_3d_task，list_text_to_3d_tasks，stream_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
• 纹理：create_text_to_texture_task，retrieve_text_to_texture_task，list_text_to_texture_tasks，stream_text_to_texture_task
• 重新网格化：create_remesh_task，retrieve_remesh_task，list_remesh_tasks，stream_remesh_task
• 骨骼绑定：create_rigging_task，retrieve_rigging_task，list_rigging_tasks，stream_rigging_task
• 动画：create_animation_task，retrieve_animation_task，list_animation_tasks，stream_animation_task
• 实用工具：get_balance

许可证

MIT