3d Asset Processing MCP

🚀 3D资产处理MCP

这是一个全面的MCP服务器，支持处理、验证、优化和分析带有glTF/GLB格式的3D模型。

🚀 快速开始

本项目是一个用于处理、验证、优化和分析3D模型的MCP服务器，支持glTF/GLB格式。通过简单配置即可集成到MCP客户端中使用。

✨ 主要特性

• 分析：获取详细的模型统计信息，包括几何结构、材质、动画和性能指标。
• 验证：使用内置检查确保3D模型符合标准。
• 基础处理：使用gltf - pipeline在glTF/GLB格式之间进行转换。
• 高级处理：使用gltf - transform应用Meshopt/Draco压缩、纹理优化和几何处理。

📦 安装指南

将以下配置添加到你的MCP客户端配置中：

{
  "mcpServers": {
    "3d-asset-processing-mcp": {
      "command": "npx",
      "args": ["-y", "3d-asset-processing-mcp@0.0.1-beta.5"]
    }
  }
}

所有依赖项（gltf - pipeline、gltf - transform）都已包含在内，无需额外设置。

💻 使用示例

基础用法

本项目提供了多个可用工具，以下是一些基础的使用示例：

# 分析3D模型并提供详细统计信息
npx analyze_model your_model.gltf

# 验证3D模型的合规性和兼容性
npx validate_model your_model.gltf

# 进行基础的glTF操作（转换、格式升级、简单压缩）
npx gltf-pipeline-executor your_model.gltf

# 进行高级的glTF处理（Meshopt/Draco压缩、纹理优化、几何处理）
npx gltf-transform-executor your_model.gltf

高级用法

在开发和调试过程中，你可以按照以下步骤进行操作：

# 克隆仓库
git clone git@github.com:GeoLibra/3d-asset-processing-mcp.git
cd 3d-asset-processing-mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 调试mcp
"3d-asset-processing-mcp": {
  "command": "node",
  "args": [
    "/Users/hgis/myproject/3d-asset-processing-mcp/dist/server.js"
  ]
}

# 运行调试工具
npx @modelcontextprotocol/inspector

📄 许可证

本项目采用MIT许可证。