unity-mcp
Unity MCPは、Unityエディタと大規模言語モデル（LLM）を接続するためのツールです。ユーザーは自然言語で指示を出し、アセットの管理やシーンの制御、スクリプトの編集、タスクの自動化を行うことができます。MCPクライアントを介して、さまざまなAIアシスタントと連携できるため、開発者は効率的に作業を進めることができます。
GitHubスター
3,102
ユーザー評価
未評価
お気に入り
0
閲覧数
38
フォーク
407
イシュー
26
インストール方法
難易度
中級推定所要時間
10-20 分
必要な環境
Git CLI: Required for cloning the repository.Python: Version 3.12 or newer.+2 more
インストール方法
インストール方法
前提条件
必要なソフトウェアとバージョンを明記してください。Git CLI: リポジトリをクローンするために必要です。 [Gitをダウンロード](https://git-scm.com/downloads)
Python: バージョン3.12以上が必要です。 [Pythonをダウンロード](https://www.python.org/downloads/)
Unity Hub & Editor: バージョン2020.3 LTS以上が必要です。 [Unityをダウンロード](https://unity.com/download)
uv (Pythonパッケージマネージャー):
bash
pip install uv
MCPクライアント: 必要です。
インストール手順
1. リポジトリのクローン
bash
git clone https://github.com/justinpbarnett/unity-mcp
cd unity-mcp
2. 依存関係のインストール
bash
pip install -r requirements.txt
3. サーバーの起動
bash
python server.py
トラブルシューティング
よくある問題
問題: サーバーが起動しない 解決策: Pythonのバージョンを確認し、依存関係を再インストールしてください。 問題: Unityエディターが接続できない 解決策: Unity MCP Bridgeが正しくインストールされていることを確認してください。設定方法
設定方法
基本設定
Unityエディター内でMCPブリッジを設定します。パッケージマネージャーを使用してインストールします。詳細設定
環境変数
必要に応じて以下の環境変数を設定：bash
export MCP_SERVER_URL="http://localhost:3000"
設定例
json
{
"mcpServers": {
"unity-mcp": {
"command": "python",
"args": ["server.py"],
"env": {
"MCP_SERVER_URL": "http://localhost:3000"
}
}
}
}
使用例
使用例
基本的な使用方法
Unityエディターでの使用
1MCPサーバーの起動確認
Unityエディターを開き、MCPブリッジが正しく動作していることを確認します。
2基本コマンドの実行
Available tools from this MCP server:
- read_console: コンソールメッセージを取得
- manage_scene: シーンを管理
プログラムでの使用
csharp
// C#例
using System;
using UnityEngine;
public class MCPExample : MonoBehaviour {
void Start() {
// MCPクライアントを使用してツールを呼び出す
CallMCPTool("manage_scene", new { action = "load", sceneName = "MainScene" });
}
}
使用ケース
AIアシスタントを使用して、Unityエディター内でアセットを自動的にインポートする。
自然言語でシーンをロードまたは保存するコマンドを発行する。
スクリプトを自動生成し、エディター内で直接編集する。
複数のゲームオブジェクトを一括で作成または削除する。
エディターのコンソールメッセージを取得またはクリアする。