UniMCP4CC

# UniMCP4CC - Unity MCP Server for Claude Code Unity Editor を Claude Code から操作するための MCP (Model Context Protocol) サーバーです。 > **Note**: このパッケージは Claude Code 専用に設計・テストされています。 ## 機能 Claude Code から Unity Editor を直接操作できます： - **シーン操作**: GameObjectの作成・削除・検索 - **コンポーネント操作**: コンポーネントの追加・削除・プロパティ変更 - **アセット操作**: アセットの検索・インポート・作成 - **プレハブ操作**: プレハブの作成・インスタンス化 - **オーディオ操作**: AudioSourceの作成・再生制御 ## 必要要件 - Unity 2021.3 LTS 以降 - Node.js 18 以降 - Claude Code (Anthropic) ## インストール ### 1. Unity Package Manager からインストール Unity Editor で `Window > Package Manager` を開き、`+` > `Add package from git URL...` を選択: ``` https://github.com/dsgarage/UniMCP4CC.git ``` ### 2. Claude Code の設定 パッケージインストール後、Unity Editor で: `Window > Unity MCP > Setup Claude Code` 表示されるウィンドウで「Setup Claude Code」ボタンをクリックすると、自動的に設定が行われます。 ### 手動設定（オプション） `~/.mcp.json` に以下を追加: ```json { "mcpServers": { "unity-mcp": { "command": "node", "args": [ "/path/to/your/unity/project/Library/PackageCache/com.dsgarage.unimcp4cc@xxx/Server~/mcp-bridge/index.js" ] } } } ``` ## 使用方法 1. Unity Editor を起動（MCP Server が自動起動します） 2. Claude Code を起動 3. Unity プロジェクトについて Claude Code に質問・指示 ### 使用例 ``` Claude Code: "Main Camera の位置を (0, 5, -10) に移動して" Claude Code: "新しい Cube を作成して Player という名前をつけて" Claude Code: "Player に Rigidbody コンポーネントを追加して" ``` ## API カテゴリ | カテゴリ | 説明 | API数 | |---------|------|-------| | scene | シーン操作 | 7 | | gameObject | GameObject操作 | 4 | | component | コンポーネント操作 | 12 | | transform | Transform操作 | 3 | | asset | アセット操作 | 17 | | prefab | プレハブ操作 | 5 | | audio | オーディオ操作 | 39 | | editor | エディタ操作 | 7 | | log | ログ操作 | 6 | ## アーキテクチャ ``` Claude Code → MCP Bridge (Node.js) → Unity MCP Server → Unity Editor ``` 詳細は [MCP Server Architecture](docs/MCP_SERVER_ARCHITECTURE.md) を参照してください。 ## トラブルシューティング ### 接続できない場合 1. Unity Editor が起動しているか確認 2. Console に `[MCP] HTTP Server started on port 5051` が表示されているか確認 3. `~/.mcp.json` のパスが正しいか確認 4. Claude Code を再起動 ### ポートが使用中の場合 Unity Editor で `Window > Unity MCP > Setup Claude Code` を開き、ポート番号を変更できます。 ## ライセンス MIT License - 詳細は [LICENSE](LICENSE) を参照してください。 ## 関連リンク - [Claude Code](https://claude.com/claude-code) - [Model Context Protocol](https://modelcontextprotocol.io/) - [MCP Server Architecture](docs/MCP_SERVER_ARCHITECTURE.md) --- Made with Claude Code by dsgarage