horooko
97ac0f71f5
https://assetstore.unity.com/packages/tools/generative-ai/synaptic-ai-pro-natural-language-control-for-unity-336030
301 lines
11 KiB
Markdown
301 lines
11 KiB
Markdown
# Synaptic Pro - MCP Unity Integration
|
||
# Synaptic Pro - Unity MCP 統合
|
||
|
||
[English](#english) | [日本語](#japanese)
|
||
|
||
---
|
||
|
||
<a name="english"></a>
|
||
## English
|
||
|
||
Transform your Unity development with AI-powered automation and natural language control. With **354 professional tools**, Synaptic Pro revolutionizes game creation through seamless AI integration.
|
||
|
||
### Key Features
|
||
|
||
#### **AI Integration**
|
||
- **Multi-Platform Support**: Claude Desktop, ChatGPT Desktop, Claude Code CLI, Gemini CLI, Codex CLI, Windsurf, Cline
|
||
- **Natural Language Control**: Control Unity entirely through plain English commands
|
||
- **Real-time Synchronization**: Instant feedback between Unity and AI clients
|
||
- **One-Click Setup**: Automatic configuration for all supported AI platforms
|
||
|
||
#### **Token SuperSave Mode** (Recommended)
|
||
- **99% Context Reduction**: Only 3 meta-tools instead of 354
|
||
- `list_categories()` - Discover available tool categories
|
||
- `list_tools(category)` - See tools & parameters in a category
|
||
- `execute(tool, params)` - Run any tool by name
|
||
- Best for long AI sessions - more context for conversation
|
||
|
||
#### **HTTP Server Mode**
|
||
- **Direct REST API**: No MCP client required
|
||
- Port 8086 (configurable)
|
||
- Endpoints: `/health`, `/tools`, `/execute`, `/batch`, `/prompt`
|
||
- Perfect for custom integrations and automation scripts
|
||
|
||
#### **354 Professional Tools** (34 Categories)
|
||
- **VFX** (47 tools): Visual effects, particles, VFX Graph editing
|
||
- **Utility** (26 tools): Batch operations, project analysis
|
||
- **UI** (16 tools): Complete UI systems from descriptions
|
||
- **Animation** (16 tools): Animators, clips, state machines
|
||
- **Asset Management** (16 tools): Import, organize, optimize assets
|
||
- **Material** (14 tools): PBR materials, shader properties
|
||
- **Audio** (14 tools): 3D spatial audio, adaptive music
|
||
- **Monitoring** (14 tools): Performance tracking, debugging
|
||
- **Camera** (13 tools): Cinemachine, virtual cameras, dolly tracks
|
||
- **Input** (13 tools): Custom mapping, gestures, accessibility
|
||
- **Shader** (13 tools): URP/HDRP/Built-in compatible shaders
|
||
- **GameObject** (12 tools): Create, transform, manage objects
|
||
- **Lighting** (10 tools): Realtime/baked lighting, probes
|
||
- **GOAP** (10 tools): Goal-oriented action planning AI
|
||
- **+ 20 more categories...**
|
||
|
||
#### **Dynamic Meta-Tools**
|
||
- `unity_dynamic_inspect` - Inspect any GameObject, component, or asset
|
||
- `unity_dynamic_modify` - Modify any property using property paths
|
||
- `unity_dynamic_create` - Universal creation (objects, prefabs, scenes, components)
|
||
|
||
### Advanced AI Systems
|
||
|
||
#### **GOAP (Goal-Oriented Action Planning)**
|
||
Full runtime engine with C# implementation:
|
||
```
|
||
"Create a guard AI that patrols waypoints, investigates noises,
|
||
and calls for backup when health is below 30%"
|
||
```
|
||
|
||
Pre-built templates:
|
||
- Guard AI (patrol, investigate, engage)
|
||
- Collector AI (gather resources, deliver)
|
||
- Hunter AI (track and pursue targets)
|
||
- Companion AI (follow and assist player)
|
||
- Merchant AI (trading and economy)
|
||
|
||
#### **Behavior Tree Runtime**
|
||
- Selector, Sequence, Parallel composites
|
||
- Decorators: Inverter, Repeater, Cooldown
|
||
- Action nodes: Wait, MoveTo, Log, SetBlackboard
|
||
|
||
#### **Built-in Shaders** (URP/HDRP/Built-in)
|
||
- **SynapticWaterPro**: Ocean with Gerstner waves, foam, caustics
|
||
- **SynapticSkyPro**: Procedural sky with volumetric clouds
|
||
- **SynapticToonPro**: Anime-style cel shading
|
||
- **SynapticGrassPro**: GPU-instanced grass with wind
|
||
|
||
#### **VFX Textures**
|
||
- 150+ CC0 textures (Kenney assets)
|
||
- Fire, smoke, explosions, sparks, magic effects
|
||
|
||
### Technical Architecture
|
||
|
||
- **WebSocket Server**: Real-time bidirectional communication (port 8090)
|
||
- **HTTP Server**: REST API for direct access (port 8086)
|
||
- **Main Thread Dispatcher**: Safe Unity API calls from async operations
|
||
- **Auto-Retry System**: Handles Unity recompilation gracefully (30 retries, 5 min max)
|
||
- **Auto-Reconnection**: Maintains connection stability
|
||
|
||
### Requirements
|
||
|
||
- Unity 2022.3 LTS or higher
|
||
- Windows 10/11, macOS 10.15+, or Linux Ubuntu 20.04+
|
||
- Node.js 16+ (for MCP server)
|
||
- 4GB RAM minimum (8GB recommended)
|
||
|
||
### Quick Start
|
||
|
||
1. **Installation**
|
||
```
|
||
1. Import from Unity Asset Store
|
||
2. Go to: Synaptic Pro > Setup
|
||
3. Select mode: SuperSave (Recommended) or Full
|
||
4. Click "Complete MCP Setup"
|
||
5. Click "Start AI Connection"
|
||
```
|
||
|
||
2. **Basic Usage**
|
||
```
|
||
"Create a red cube at position 0,5,0"
|
||
"Add rigidbody to the selected object"
|
||
"Create sunny weather with clouds"
|
||
"Generate a UI health bar in top left"
|
||
```
|
||
|
||
3. **Advanced Examples**
|
||
```
|
||
"Create a complete third-person controller with animations"
|
||
"Setup an inventory system with 5x5 grid"
|
||
"Create a day-night cycle that lasts 10 minutes"
|
||
"Generate an enemy spawner that increases difficulty over time"
|
||
```
|
||
|
||
### Troubleshooting
|
||
|
||
**Newtonsoft.Json Missing?**
|
||
```
|
||
Package Manager > + > Add package by name
|
||
Enter: com.unity.nuget.newtonsoft-json
|
||
```
|
||
|
||
**Connection Issues?**
|
||
1. Check Node.js: `node --version`
|
||
2. Verify server status in Unity console
|
||
3. Restart: `Synaptic Pro > Restart Server`
|
||
|
||
### Links
|
||
|
||
- **Discord Community**: [Join us](https://discord.com/invite/Y2nUyWvqR3)
|
||
|
||
---
|
||
|
||
<a name="japanese"></a>
|
||
## 日本語
|
||
|
||
**354のプロフェッショナルツール**で、AIパワーによる自動化と自然言語制御でUnity開発を革新します。Synaptic ProはAI統合によるゲーム制作の新しい形を提供します。
|
||
|
||
### 主な機能
|
||
|
||
#### **AI統合**
|
||
- **マルチプラットフォーム対応**: Claude Desktop、ChatGPT Desktop、Claude Code CLI、Gemini CLI、Codex CLI、Windsurf、Cline
|
||
- **自然言語制御**: 日本語や英語の普通の文章でUnityを完全制御
|
||
- **リアルタイム同期**: UnityとAIクライアント間の即時フィードバック
|
||
- **ワンクリック設定**: 対応AI全プラットフォームの自動設定
|
||
|
||
#### **Token SuperSave Mode**（推奨）
|
||
- **99%コンテキスト削減**: 354ツールの代わりに3つのメタツールのみ
|
||
- `list_categories()` - 利用可能なカテゴリを確認
|
||
- `list_tools(category)` - カテゴリ内のツールとパラメータを表示
|
||
- `execute(tool, params)` - ツール名で任意のツールを実行
|
||
- 長いAIセッションに最適 - 会話により多くのコンテキストを使用可能
|
||
|
||
#### **HTTP Serverモード**
|
||
- **直接REST API**: MCPクライアント不要
|
||
- ポート8086（設定可能）
|
||
- エンドポイント: `/health`, `/tools`, `/execute`, `/batch`, `/prompt`
|
||
- カスタム統合や自動化スクリプトに最適
|
||
|
||
#### **354のプロフェッショナルツール**（34カテゴリ）
|
||
- **VFX** (47): ビジュアルエフェクト、パーティクル、VFX Graph編集
|
||
- **Utility** (26): バッチ操作、プロジェクト分析
|
||
- **UI** (16): 説明文から完全なUIシステムを生成
|
||
- **Animation** (16): アニメーター、クリップ、ステートマシン
|
||
- **Asset Management** (16): アセットのインポート、整理、最適化
|
||
- **Material** (14): PBRマテリアル、シェーダープロパティ
|
||
- **Audio** (14): 3D空間音響、アダプティブ音楽
|
||
- **Monitoring** (14): パフォーマンス追跡、デバッグ
|
||
- **Camera** (13): Cinemachine、仮想カメラ、ドリートラック
|
||
- **Input** (13): カスタムマッピング、ジェスチャー、アクセシビリティ
|
||
- **Shader** (13): URP/HDRP/Built-in対応シェーダー
|
||
- **GameObject** (12): オブジェクトの作成、変形、管理
|
||
- **Lighting** (10): リアルタイム/ベイクドライティング、プローブ
|
||
- **GOAP** (10): ゴール指向行動計画AI
|
||
- **+ 他20カテゴリ...**
|
||
|
||
#### **Dynamic Meta-Tools**
|
||
- `unity_dynamic_inspect` - 任意のGameObject、コンポーネント、アセットを調査
|
||
- `unity_dynamic_modify` - プロパティパスで任意のプロパティを変更
|
||
- `unity_dynamic_create` - 汎用作成（オブジェクト、プレハブ、シーン、コンポーネント）
|
||
|
||
### 高度なAIシステム
|
||
|
||
#### **GOAP（ゴール指向行動計画）**
|
||
C#実装による完全なランタイムエンジン：
|
||
```
|
||
"巡回して、物音を調査し、体力が30％以下になったら
|
||
援軍を呼ぶ警備AIを作成して"
|
||
```
|
||
|
||
組み込みテンプレート：
|
||
- ガードAI（巡回、調査、交戦）
|
||
- コレクターAI（リソース収集、配送）
|
||
- ハンターAI（追跡と追撃）
|
||
- コンパニオンAI（プレイヤーの追従と支援）
|
||
- 商人AI（取引と経済）
|
||
|
||
#### **Behavior Tree Runtime**
|
||
- Selector、Sequence、Parallelコンポジット
|
||
- デコレーター: Inverter、Repeater、Cooldown
|
||
- アクションノード: Wait、MoveTo、Log、SetBlackboard
|
||
|
||
#### **内蔵シェーダー**（URP/HDRP/Built-in対応）
|
||
- **SynapticWaterPro**: Gerstner波、泡、コースティクス付きオーシャン
|
||
- **SynapticSkyPro**: ボリュメトリッククラウド付きプロシージャルスカイ
|
||
- **SynapticToonPro**: アニメ調セルシェーディング
|
||
- **SynapticGrassPro**: 風アニメーション付きGPUインスタンス草
|
||
|
||
#### **VFXテクスチャ**
|
||
- 150以上のCC0テクスチャ（Kenneyアセット）
|
||
- 炎、煙、爆発、スパーク、魔法エフェクト
|
||
|
||
### 技術アーキテクチャ
|
||
|
||
- **WebSocketサーバー**: リアルタイム双方向通信（ポート8090）
|
||
- **HTTPサーバー**: 直接アクセス用REST API（ポート8086）
|
||
- **メインスレッドディスパッチャー**: 非同期操作からの安全なUnity API呼び出し
|
||
- **自動リトライシステム**: Unityリコンパイルを適切に処理（30回リトライ、最大5分）
|
||
- **自動再接続**: 接続の安定性を維持
|
||
|
||
### 必要環境
|
||
|
||
- Unity 2022.3 LTS以上
|
||
- Windows 10/11、macOS 10.15以上、またはLinux Ubuntu 20.04以上
|
||
- Node.js 16以上（MCPサーバー用）
|
||
- 最小4GB RAM（推奨8GB）
|
||
|
||
### クイックスタート
|
||
|
||
1. **インストール**
|
||
```
|
||
1. Unity Asset Storeからインポート
|
||
2. メニュー：Synaptic Pro > Setup
|
||
3. モード選択：SuperSave（推奨）またはFull
|
||
4. 「Complete MCP Setup」をクリック
|
||
5. 「Start AI Connection」をクリック
|
||
```
|
||
|
||
2. **基本的な使い方**
|
||
```
|
||
"位置0,5,0に赤いキューブを作成"
|
||
"選択中のオブジェクトにRigidbodyを追加"
|
||
"雲のある晴天を作成"
|
||
"左上にUIヘルスバーを生成"
|
||
```
|
||
|
||
3. **高度な例**
|
||
```
|
||
"アニメーション付きの完全な三人称コントローラーを作成"
|
||
"5x5グリッドのインベントリシステムをセットアップ"
|
||
"10分間続く昼夜サイクルを作成"
|
||
"時間とともに難易度が上がる敵スポナーを生成"
|
||
```
|
||
|
||
### トラブルシューティング
|
||
|
||
**Newtonsoft.Jsonが見つからない？**
|
||
```
|
||
Package Manager > + > Add package by name
|
||
入力: com.unity.nuget.newtonsoft-json
|
||
```
|
||
|
||
**接続の問題？**
|
||
1. Node.jsを確認: `node --version`
|
||
2. Unityコンソールでサーバーステータスを確認
|
||
3. 再起動: `Synaptic Pro > Restart Server`
|
||
|
||
### リンク
|
||
|
||
- **Discordコミュニティ**: [参加する](https://discord.com/invite/Y2nUyWvqR3)
|
||
|
||
---
|
||
|
||
## Why Choose Synaptic Pro?
|
||
|
||
- **Save 80% Development Time**: Automate repetitive tasks
|
||
- **No Coding Required**: Natural language commands
|
||
- **Enterprise-Ready**: Production-quality code generation
|
||
- **Active Community**: Regular updates and support
|
||
- **Future-Proof**: AI-powered development is the future
|
||
|
||
---
|
||
|
||
**Transform your Unity workflow today with Synaptic Pro!**
|
||
|
||
© 2025 Synaptic Team. All rights reserved.
|