[!警告] このリポジトリは非推奨です。 開発は、akiojin/unity-cliに移りました。 このリポジトリは更新を受け取りません。 後継プロジェクトに移行してください。

日本語 | English

概要

Unity MCP Server では、LLM ベースのクライアントが Unity エディターを自動生成できます。 シンプルなインターフェイスとゼロまたは低構成のセットアップで、信頼性のあるスクリプト可能なワークフローに焦点を当てています。

できること

• Editorのオートメーション: シーン、GameObject、コンポーネント、プレハブ、マテリアルの作成/変更
• UIのオートメーション: UIと連携し、UIの状態を検証
• 入力シミュレーション: キーボード/マウス/ゲームパッド/プレイモードのテストのための接触(入力システムだけ)
• ビジュアルキャプチャ: ゲーム/シーン/エクスプローラ/ウィンドウビューから決定的なスクリーンショット
• コードベース認識: バンドルしたC# LSP(.sln]なし)ファイルによる安全な構造編集と正確なシンボル/search
• プロジェクト制御: 読み取り/更新プロジェクト/編集設定; ログを読みます, モニターのコンパイル
• 指定可能な管理: アセットの登録・整理、グループ管理、自動化の構築

パフォーマンス

コードインデックスツールは、標準ファイル操作を出力します。

| 営業 | コードインデックスツール | 標準ツール | 利点 |

Unity MCP Server

[!WARNING] This repository is deprecated. Development has moved to akiojin/unity-cli. This repository will no longer receive updates. Please migrate to the successor project.

English | 日本語

Overview

Unity MCP Server lets LLM-based clients automate the Unity Editor. It focuses on reliable, scriptable workflows with a simple interface and zero or low-configuration setup.

What It Can Do

• Editor automation: Create/modify scenes, GameObjects, components, prefabs, materials
• UI automation: Locate and interact with UI, validate UI state
• Input simulation: Keyboard/mouse/gamepad/touch for playmode testing (Input System only)
• Visual capture: Deterministic screenshots from Game/Scene/Explorer/Window views
• Code base awareness: Safe structured edits and accurate symbol/search powered by bundled C# LSP (no .sln file required)
• Project control: Read/update project/editor settings; read logs, monitor compilation
• Addressables management: Register/organize assets, manage groups, build automation

Performance

Code index tools outperform standard file operations:

Key benefits:

• 128,040 files indexed with 100% coverage
• Non-blocking background index builds (Worker Threads)
• LLM-optimized output with pagination and size limits

For detailed benchmarks, see docs/benchmark-results-2025-12-13.md

Requirements

• Unity 2020.3 LTS or newer
• Node.js 18.x / 20.x / 22.x / 24.x LTS (25+ not supported)
• Claude Desktop or another MCP-compatible client

Installation

Unity Package

Package Manager → Add from git URL:

https://github.com/akiojin/unity-mcp-server.git?path=UnityMCPServer/Packages/unity-mcp-server

Or via OpenUPM:

openupm add com.akiojin.unity-mcp-server

MCP Client Configuration

Configure your MCP client (Claude Desktop example):

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "npx",
      "args": ["@akiojin/unity-mcp-server@latest"]
    }
  }
}

HTTP Mode (for HTTP-only networks)

npx @akiojin/unity-mcp-server --http 6401 --no-telemetry
curl http://localhost:6401/healthz

Quick Start

1. Install the Unity package (Git URL or OpenUPM)
2. Configure your MCP client with the JSON above