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許可證。