3d MCP

🚀 3D-MCPアーキテクチャの概要

3D-MCPは革新的なプロジェクトで、単一のAPIを通じて様々な3Dソフトウェアを統合することを目指しています。このプロジェクトはモジュール化と階層化の設計手法を採用しており、拡張と保守を効率的かつ秩序正く行うことができます。

🚀 クイックスタート

依存関係のインストール

bun install

サンプルの実行

bun run examples/hello-world.ts

プラグインの作成

1. 新しいプラグインを作成します：

   npm init -y my-plugin
   

2. アダプターロジックを実装します。
3. パッケージ化して配布します。

✨ 主な機能

3D-MCPは、システムを複数の独立したコンポーネントに分割することで、各コンポーネントに特定の機能領域を担当させます。この設計により、システムの保守性が向上し、クロスプラットフォーム開発が容易になります。

📚 ドキュメント

全体的なアーキテクチャ

3D-MCPの核心理念は、システムを複数の独立したコンポーネントに分割し、各コンポーネントに特定の機能領域を担当させることです。この設計により、システムの保守性が向上し、クロスプラットフォーム開発が容易になります。

コアコンポーネント

• エンティティ定義：すべての機能領域で共有される基本エンティティは、core/entity.tsで一元管理されます。
• アトミック操作：特定の機能領域に関するアトミック操作は、それぞれのファイル（例：atomic.ts）に格納されます。
• 複合操作生成器：アトミック操作を組み合わせて、高レベルの複合ツールを自動生成します。これはcompounded.tsファイルにあります。

機能モジュール

• コアモジュール：すべての領域で共有される基本エンティティとツールを提供します。
• モデリングモジュール：メッシュの作成、編集、トポロジー操作を処理します。
• アニメーションモジュール：キーフレーム、アニメーション曲線、フラグメントなどのアニメーション関連の機能を管理します。
• バインディングモジュール：骨格システム、コントロール階層、変形操作を担当します。
• レンダリングモジュール：マテリアル、照明、レンダリング設定を構成します。

階層化設計

3D-MCPは4層のアーキテクチャを採用しており、各層には明確な役割が割り当てられています。

1. 表示層：データのシリアル化と逆シリアル化を処理し、異なるプラットフォーム間でのデータ互換性を確保します。
2. サービス層：核心的なビジネスロジックをカプセル化し、統一されたAPIインターフェースを提供します。
3. 永続化層：データの保存と検索機能を実装し、複数の保存方式をサポートします。
4. アダプター層：具体的な3Dソフトウェアの統合を担当し、プラグイン形式でシステムを拡張します。

ドメイン組織

各機能モジュールは特定のワークフローに従って組織されています。

コアコンポーネント

• 基本エンティティ：すべてのドメインで共通の基本データ構造は、core/entity.tsに定義されています。
• 汎用ツール：ドメインをまたいで使用される共有機能とユーティリティは、utils.tsにあります。

モデリングドメイン

• エンティティ定義：メッシュ、頂点、面などの核心的なモデリング概念の定義が含まれています。
• アトミック操作：メッシュの作成、トポロジーの変更などの基本操作です。
• 複合ツール：ブール演算、细分曲面などの高度なモデリング機能を提供します。

アニメーションドメイン

• エンティティ定義：キーフレーム、アニメーション曲線、フラグメントなどのアニメーション関連の概念が含まれています。
• アトミック操作：キーフレームの挿入、曲線の調整などの基本的なアニメーション制御です。
• 複合ツール：レイヤーアニメーション、条件判断などの複雑なアニメーションロジックの編成をサポートします。

バインディングドメイン

• エンティティ定義：骨格、IKチェーン、コントロール階層などのバインディング関連の概念が含まれています。
• アトミック操作：関節の作成、拘束の追加などの基本的なバインディング操作です。
• 複合ツール：自動ウェイトの描画、変形ターゲットの管理などの高度なバインディング機能を提供します。

レンダリングドメイン

• エンティティ定義：カメラ、光源、レンダリング設定などが含まれています。
• アトミック操作：マテリアルの作成、照明の設定などの基本的なレンダリング制御です。
• 複合ツール：グローバルな照明設定、ポストエフェクトの重ね合わせなどの複雑なレンダリングロジックの編成をサポートします。

エンティティ中心のCRUDアーキテクチャ

3D-MCPはエンティティ中心の設計理念を採用しており、各ドメインには独自のエンティティモデルがあります。これらのエンティティはZodスキーマで定義され、CRUD（作成、読み取り、更新、削除）操作が自動生成されることで、開発効率が大幅に向上します。

コアコンポーネント

• 基本エンティティ：core/entity.tsで一元管理されます。
• 共有機能：ドメインをまたいで使用される共有機能とユーティリティを提供します。

ドキュメントの拡張

3D-MCPの実装詳細をさらに理解するには、以下のドキュメントを参照してください。

• APIリファレンス
• 開発ガイド
• プラグイン作成チュートリアル

以上の設計により、3D-MCPは各機能領域を効果的に分離するとともに、システムの高い拡張性と保守性を確保しています。このモジュール化された設計思想により、開発者は新機能の追加やカスタマイズ開発を容易に行うことができます。