UniMCP4CC - Unity MCP Server for Claude Code
Unity Editor を Claude Code から操作するための MCP (Model Context Protocol) サーバーです。
Note: このパッケージは Claude Code 専用 に設計・テストされています。
動作環境
| 項目 | バージョン |
|---|---|
| Unity | 6000.0.0 以降 (Unity 6) |
| Node.js | 18 以降 |
| AI Client | Claude Code (Anthropic) |
Important: このパッケージは Unity 6 (6000.x) 向けにビルドされています。Unity 2021/2022 では動作しない可能性があります。
機能
Claude Code から Unity Editor を直接操作できます:
- シーン操作: GameObject の作成・削除・検索
- コンポーネント操作: コンポーネントの追加・削除・プロパティ変更
- アセット操作: アセットの検索・インポート・作成
- プレハブ操作: プレハブの作成・インスタンス化
- オーディオ操作: AudioSource の作成・再生制御
インストール
Unity Package Manager からインストール
Unity Editor で Window > Package Manager を開き、+ > Add package from git URL... を選択:
https://github.com/dsgarage/UniMCP4CC.git
Claude Code の設定
方法1: Unity Editor から自動設定(推奨)
パッケージインストール後、Unity Editor で:
Window > Unity MCP > Setup Claude Code
表示されるウィンドウで「Setup Claude Code」ボタンをクリックすると、自動的に設定が行われます。
方法2: シェルスクリプトで設定
# Unity プロジェクトのルートディレクトリで実行
cd /path/to/YourUnityProject
# セットアップスクリプトを実行
bash Packages/com.dsgarage.unimcp4cc/Server/mcp-bridge/setup-mcp-bridge.sh
スクリプトが自動的に:
mcp-bridge/ディレクトリをプロジェクトルートに作成- 必要なファイルをコピー
- npm 依存関係をインストール
- Claude Code の設定例を表示
方法3: 手動設定
# Unity プロジェクトのルートディレクトリに移動
cd /path/to/YourUnityProject
# mcp-bridge ディレクトリを作成
mkdir mcp-bridge
# テンプレートファイルをコピー
cp Packages/com.dsgarage.unimcp4cc/Server/mcp-bridge/index.js mcp-bridge/
cp Packages/com.dsgarage.unimcp4cc/Server/mcp-bridge/package.json mcp-bridge/
# npm 依存関係をインストール
cd mcp-bridge
npm install
その後、~/.claude.json に以下を追加:
{
"mcpServers": {
"unity": {
"command": "node",
"args": ["/absolute/path/to/YourUnityProject/mcp-bridge/index.js"]
}
}
}
使用方法
- Unity Editor を起動(MCP Server が自動起動します)
- Claude Code を起動
- Unity プロジェクトについて Claude Code に質問・指示
使用例
"Main Camera の位置を (0, 5, -10) に移動して"
"新しい Cube を作成して Player という名前をつけて"
"Player に Rigidbody コンポーネントを追加して"
API カテゴリ
| カテゴリ | 説明 |
|---|---|
| scene | シーン操作 |
| gameObject | GameObject 操作 |
| component | コンポーネント操作 |
| transform | Transform 操作 |
| asset | アセット操作 |
| prefab | プレハブ操作 |
| audio | オーディオ操作 |
| editor | エディタ操作 |
| log | ログ操作 |
詳細な API リファレンスは Wiki を参照してください。
アーキテクチャ
Claude Code → MCP Bridge (Node.js) → Unity MCP Server → Unity Editor
トラブルシューティング
接続できない場合
- Unity Editor が起動しているか確認
- Console に
[MCP] HTTP Server started on port 5051が表示されているか確認 - Claude Code を再起動
Unity バージョンの互換性
このパッケージは Unity 6 (6000.x) 向けにビルドされています。 他のバージョンで問題が発生した場合は Issue を作成してください。
ライセンス
MIT License
関連リンク
Made with Claude Code by dsgarage
