Unity MCP サーバー

Unity ゲーム開発用のモデルコンテキストプロトコル (MCP) サーバー。AI アシスタントが一連の専用ツールを通じて Unity プロジェクトと対話できるようになります。

概要

Unity MCPサーバーは、AIアシスタント（Cursor AIやClaudeなど）とUnityプロジェクト間の橋渡し機能を提供します。以下のツールを提供します。

Unity プロジェクトでのファイルの読み取りと検索
Unityシーンとプレハブの解析
C#コードの解析とエラーの検出
バッチモードでの自動テストの実行
テンプレートからスクリプトを生成する
シェーダーの検証
さらに…

サーバーは Unity でバッチモードで実行するように設計されており、エディター GUI を必要とせずに Unity エンジンを必要とする操作を可能にします。

インストール

前提条件

Node.js 16以上
Unity 2022.3 LTS 以降（推奨）

設定

このリポジトリをクローンします:
git clone https://github.com/GrandMasterK414/unity-smithery-mcp.git cd unity-smithery-mcp
依存関係をインストールします:
npm install
プロジェクトをビルドします。
npm run build

構成

サーバーは設定にconfigパッケージを使用します。設定を調整するには、 config/default.jsonを編集してください。

{
  "server": {
    "port": 3000,
    "host": "0.0.0.0"
  },
  "unity": {
    "unityPath": "/path/to/Unity/Editor/Unity",
    "projectPath": "/path/to/your/unity/project",
    "timeoutMs": 60000,
    "batchMode": true
  },
  "logging": {
    "level": "info",
    "file": "logs/mcp-server.log",
    "maxSize": 5242880,
    "maxFiles": 5
  },
  "security": {
    "allowedPaths": ["Assets", "ProjectSettings", "Packages"],
    "disallowedCommands": ["rm", "del", "format", "shutdown"]
  }
}

使用法

サーバーの起動

npm start

Smithery モードで実行するには:

npm run smithery:start

AIアシスタントと併用する

このサーバーは、MCP仕様で定義されたツールを介してAIアシスタントと連携するために主に設計されています。CursorまたはSmithery.aiとの統合については、それぞれのドキュメントに従ってこのMCPサーバーに接続してください。

利用可能なツール

ツール名	説明
`open_file`	Unityプロジェクト内のファイルの内容を読み取ります
`search_files`	プロジェクトファイル内のテキストパターンを検索します
`list_assets`	特定のタイプまたはフォルダ内のプロジェクトアセットを一覧表示します
`get_project_info`	Unityプロジェクトに関する高レベルの情報を取得します
`parse_scene`	Unityシーンファイルを解析してゲームオブジェクトの階層を抽出します
`parse_prefab`	Unityプレハブファイルを解析してコンポーネントを抽出します
`find_in_scenes`	特定のゲームオブジェクトまたはコンポーネントを含むシーンを検索します
`analyze_cs_code`	C# コードをコンパイルしてコンパイラエラーを検出します
`find_references`	C#クラスまたはメソッドへの参照を検索します
`generate_script`	テンプレートから新しい C# スクリプトファイルを作成します
`validate_shader`	シェーダをコンパイルし、エラーを報告します
`inspect_yaml`	YAMLアセットファイルを検査する
`run_tests`	Unityの自動テストをバッチモードで実行します
`simulate_playmode`	実験的 - 短時間、再生モードでシーンを実行します

Docker サポート

コンテナ化されたデプロイメント用のDockerfileが含まれています。Dockerイメージをビルドします。

docker build -t unity-mcp-server .

コンテナを実行します。

docker run -p 3000:3000 -v /path/to/unity/project:/project unity-mcp-server

Smithery.ai 統合

このサーバーは、提供されているsmithery.yaml構成を使用して Smithery.ai にデプロイできます。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！問題を報告したり、プルリクエストを送信してください。

Unity MCP Server

Integrations