ツールリファレンス

nanora-unity-mcp は 18 分類・57 ツールと、SuperSave モード用のメタツール 3 本を持っています。各ページはツールの C# クラスから生成しているので、AI クライアントが tools/list で受け取る内容と同じです。

シーン

GameObject を作る・変える

• get_scene_hierarchy — Gets the GameObject hierarchy of the active scene as indented text: scene name, path, root count, then one line per object with [inactive]/[prefab] markers and its component type names.
• get_object_details — Gets details of one active GameObject: active state, layer, tag, static flag, world and local transform, parent, child count, and the type names of all components (missing scripts are marked).
• create_game_object — Creates a new GameObject in the active scene, either empty or as a primitive (Cube, Sphere, etc.), with local position/rotation/scale and an optional parent.
• modify_game_object — Modifies one existing GameObject: name, active state, local position/rotation/scale, parent, layer, or tag.
• delete_game_object — Deletes a GameObject (and all of its children) from the open scene, with Undo support.

検索

オブジェクトとアセットを探す

• query_objects — Query GameObjects using U-Selector syntax (similar to CSS selectors).
• search_assets — Search for assets in the local project using fuzzy matching.
• wait_for_selector — Poll until a GameObject matching a U-Selector (same syntax as query_objects) reaches a state, or until timeout.
• instantiate_asset — Instantiate a prefab or asset into the current scene.

一括操作

たくさんのオブジェクトをまとめて操作

• batch_modify — Batch modify multiple GameObjects matching a selector.
• set_active — Set the active state of GameObjects matching a selector.
• destroy_objects — Destroy multiple GameObjects matching a selector.

コード

C# の実行とコンパイル

• execute_csharp — Execute C# code dynamically in the Unity Editor context.
• execute_menu_item — Executes a Unity Editor menu item by its path (e.g., ‘File/Save’, ‘Edit/Undo’), including project-defined menus.
• compile_project — Trigger Unity script compilation and wait for completion (up to timeout_seconds).
• get_compilation_errors — Get current compilation errors and warnings without triggering a new compilation.

Play モード

Play モードの操作

• manage_playmode — Manage Unity Play Mode: play (enter), stop (exit), pause, resume, step one frame, or status.

テスト

テストの実行・E2E シナリオ・見た目の回帰・性能の予算

• run_tests — Run Unity Test Framework tests.
• get_test_results — Get available test results from Unity Test Framework.
• simulate_input — Simulate keyboard and mouse input for automated testing and UI interaction.
• assert_ui_state — Assert UI state matches expected value.
• run_e2e_test — Run an E2E test scenario in Play Mode.
• visual_regression_test — Visual regression testing via screenshot comparison.
• performance_budget_test — Test if the scene meets performance budgets.
• generate_test_report — Generate a comprehensive test report from E2E test, visual regression, and performance budget results.

性能

フレーム・メモリ・CPU の計測

• analyze_frame — Analyze the current frame’s rendering performance.
• analyze_memory — Analyze current memory usage.
• profile_cpu — Profile CPU performance using Unity’s ProfilerRecorder API.
• get_profiler_stats — Get available profiler statistics and current performance metrics.

マテリアル

壊れたマテリアルの診断と修復

• diagnose_materials — Diagnose material issues in the project.
• repair_materials — Repair material issues by upgrading shaders to the current render pipeline.

診断

スクリーンショット・ログ・接続と設定の確認

• mcp_status — Get Unity MCP server status: version, project path, port and URLs, uptime, and optionally the registered tool list and Unity system info.
• get_console_logs — Gets recent log messages from the Unity Console
• configure_editor — Configure Unity Editor settings for optimal MCP operation.
• capture_screenshot — Capture a PNG from the Game View or Scene View and return it as an image content block, plus a text summary.
• setup_status — Check all MCP client configuration health.
• reconfigure_client — Fix or update MCP client configurations.
• install_skills — Install or update bundled Unity workflow skills into .claude/skills/.

シーン管理

シーンファイルを開く・保存する

• manage_scene — Manage scene files: new, save, save_as, load, or info about the active scene (name, path, dirty state, root objects).

アニメーション

Animator とアニメーションクリップ

• control_animator — Control Animator component: play/stop states, set parameters, get state info
• manage_animation_clip — Manage animation clips: list, info, create simple clips

UI

UI の要素と Canvas

• create_ui_element — Create UI elements: Button, Text, Image, Panel, InputField, Slider, Toggle, Dropdown
• manage_canvas — Manage Canvas settings: render mode, sorting, scaler, and get UI hierarchy

音

AudioSource と再生

• manage_audio_source — Manage AudioSource: create, configure, list, and get info
• play_audio — Control audio playback: play, stop, pause, resume, play one-shot

ライト

ライトと全体のライティング設定

• manage_light — Manage lights: create, configure, list, and get info
• configure_lighting — Configure global lighting: ambient, fog, skybox, and bake settings

カメラ

カメラの操作と Cinemachine

• control_camera — Control cameras: create, configure, list, look at, and align to view
• setup_cinemachine — Setup Cinemachine virtual cameras and brains (requires Cinemachine package)

Editor

Editor の操作・リフレクション・一括実行

• editor_operations — Perform editor operations: undo, redo, get/set selection, and view undo history
• unity_reflect — Inspect .NET/Unity types via reflection: get type info, search types, get member details, and invoke static methods
• batch_execute — Execute multiple MCP tool calls in a single request.

アセット

アセットファイルとプレハブの操作

• manage_assets — Manage Unity project assets: get detailed info, create folders, delete, move, rename, duplicate assets, and import external files.
• manage_prefabs — Manage Unity Prefabs: create from GameObject, apply/revert instance overrides, unpack prefab instances, save prefab assets, create variants, and get prefab info.

パッケージ

Package Manager でパッケージを探す・入れる・外す

• manage_packages — Manage Unity packages: list installed, search Unity Registry, check Unity account login status, open My Assets.
• install_package — Install a Unity package from registry, Git, local path, or .unitypackage file
• uninstall_package — Uninstall a Unity package from the project

SuperSave（メタツール）

SuperSave モードで分類をたどり、ツールを呼ぶ

• execute — Execute any registered tool by name with its arguments object (args), returning that tool’s result.
• list_categories — List the Unity tool categories with the number of tools in each (e.g.
• list_tools — List the Unity tools in one category, one line each with a brief description.