3d MCP

🚀 3D-MCP架構概述

3D-MCP是一個創新項目，致力於通過單一API統一各類3D軟件。它採用模塊化、分層的設計方式，讓系統的擴展和維護高效且有序。

🚀 快速開始

安裝依賴

bun install

運行示例

bun run examples/hello-world.ts

編寫插件

1. 創建新插件：

   npm init -y my-plugin
   

2. 實現適配器邏輯。
3. 打包並分發。

✨ 主要特性

• 模塊化設計：將系統劃分為多個獨立組件，每個組件負責特定功能域，提升了系統可維護性，使跨平臺開發更便捷。
• 分層架構：採用四層架構，每層職責明確，涵蓋表示層、服務層、持久化層和適配器層。
• 以實體為中心的CRUD架構：每個域有獨特實體模型，通過Zod schema定義實體並自動生成CRUD操作，提高開發效率。

📚 詳細文檔

總體架構

3D-MCP的核心理念是把系統分割成多個獨立組件，各組件負責特定功能域。這種設計不僅增強了系統可維護性，還讓跨平臺開發變得更簡單。

核心組件

1. 實體定義：所有功能域共享的基礎實體由core/entity.ts統一管理。
2. 原子操作：針對具體功能域的原子操作分別存於各自文件（如atomic.ts）。
3. 複合操作生成器：通過組合原子操作，自動生成高層複合工具，位於compounded.ts文件。

功能模塊

• 核心模塊：提供所有域共享的基礎實體和工具。
• 建模模塊：處理網格創建、編輯及拓撲操作。
• 動畫模塊：管理關鍵幀、曲線、片段等動畫相關功能。
• 綁定模塊：負責骨骼系統、控制層級及變形操作。
• 渲染模塊：配置材質、光照及渲染設置。

分層設計

3D-MCP採用四層架構，每層職責清晰：

1. 表示層：處理數據的序列化與反序列化，保證不同平臺間的數據兼容性。
2. 服務層：封裝核心業務邏輯，提供統一API接口。
3. 持久化層：實現數據存儲與檢索功能，支持多種存儲方案。
4. 適配器層：負責具體3D軟件的集成工作，通過插件形式擴展系統。

域組織

各功能模塊按特定工作流程組織：

核心組件

• 基礎實體：所有域共用的基礎數據結構定義在core/entity.ts。
• 通用工具：提供跨域使用的共享功能和 utilities，位於utils.ts。

建模域

• 實體定義：包含網格、頂點、面等核心建模概念的定義。
• 原子操作：如網格創建、拓撲修改等基本操作。
• 複合工具：提供高級建模功能，例如布爾運算、細分曲面等。

動畫域

• 實體定義：涵蓋關鍵幀、動畫曲線、片段等動畫相關概念。
• 原子操作：如關鍵幀插入、曲線調整等基礎動畫控制。
• 複合工具：支持複雜的動畫邏輯編排，例如層疊動畫、條件判斷等。

綁定域

• 實體定義：包含骨骼、IK鏈、控制層級等綁定相關概念。
• 原子操作：如關節創建、約束添加等基本綁定操作。
• 複合工具：提供高級綁定功能，比如自動權重繪製、變形目標管理等。

渲染域

• 實體定義：涉及相機、光源、渲染設置等內容。
• 原子操作：如材質創建、光照配置等基礎渲染控制。
• 複合工具：支持複雜的渲染邏輯編排，例如全局 illumination 設置、後處理效果疊加等。

實體為中心的CRUD架構

3D-MCP以實體為中心進行設計，每個域有獨特實體模型。通過Zod schema定義這些實體，並自動生成CRUD（創建、讀取、更新、刪除）操作，極大提升了開發效率。

核心組件

• 基礎實體：由core/entity.ts統一管理。
• 共享功能：提供跨域使用的公用功能和 utilities。

🔗 文檔擴展

如需進一步瞭解3D-MCP的實現細節，請參考以下文檔：

• API 參考
• 開發指南
• 插件編寫教程

通過以上設計，3D-MCP不僅實現了各功能域的有效隔離，還確保了系統的高度可擴展性和維護性。這種模塊化的設計思路使得開發者能夠輕鬆地添加新功能並進行定製化開發。