Is UnityMCP safe to use?

UnityMCP has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install UnityMCP?

UnityMCP supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can UnityMCP do?

UnityMCP provides 10 tools: unity_listClients, unity_setActiveClient, unity_connectToProject, unity_getActiveClient, unity_execute_code and 5 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with UnityMCP?

UnityMCP is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.

Is UnityMCP actively maintained?

UnityMCP is recently maintained — last commit was 35 days ago. It has 132 GitHub stars.

UnityMCP

Name: UnityMCP
Author: isuzu-shiranui

by isuzu-shiranui

Unity Editor integration with Model Context Protocol (MCP) enabling AI assistants like Claude to interact with Unity projects. Features a TypeScript MCP server and C# Unity plugin with extensible command handler architecture, TCP/IP communication, and dynamic plugin discovery.

132 10 tools GitHub

No known CVEs

MIT license

Maintained

Last commit 35d ago

Works with most clients

Transport: stdio, sse

10 tools · ~536 tok

Grade B · 0.3% of 200K ctx

Edit this pageView history

Developer Tools Entertainment

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unity-mcp": {
      "args": [
        "path/to/index.js"
      ],
      "command": "node"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/unitymcp)](https://mcppedia.org/s/unitymcp)

Read me

What UnityMCP does

Unity と Model Context Protocol (MCP) を統合するための拡張可能なフレームワークです。このフレームワークにより、Claude などの AI 言語モデルがスケーラブルなハンドラーアーキテクチャを通じて Unity エディタと直接対話することができます。

Test This Server

This server supports HTTP transport. Be the first to test it — help the community know if it works.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

65/100across 5 weighted dimensions

How we score →

0255075100

−35

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (10)

Click any tool to inspect its schema.

~536 tokens total

Inventory

Resources (7)

health

Version, handler list, and uptime information

unity://health

hierarchy

Scene hierarchy with filtering support (limit/offset/fields)

unity://hierarchy

inspect

GameObject and Component property inspection and manipulation

unity://inspect

screenshot

Capture Game, Scene, or Editor panel screenshots (inspector/hierarchy/project/console)

unity://screenshot

logs

Console logs retrieval with filtering

unity://logs

play_mode

Play Mode control (status/play/stop/pause/unpause/step)

unity://play_mode

resource

Assemblies and packages information

unity://resource

Inventory

Prompts (1)

code_execute

C# code template for unity_execute_code tool

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is UnityMCP safe to use?: UnityMCP has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install UnityMCP?: UnityMCP supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can UnityMCP do?: UnityMCP provides 10 tools: unity_listClients, unity_setActiveClient, unity_connectToProject, unity_getActiveClient, unity_execute_code and 5 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with UnityMCP?: UnityMCP is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is UnityMCP actively maintained?: UnityMCP is recently maintained — last commit was 35 days ago. It has 132 GitHub stars.

Similar servers

Others in developer-tools / entertainment

View all →

XcodeBuildMCP97

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

5.8k 2

XcodeBuildMCP97

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

5.8k 1

Mcp_agent_mail96

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

2.0k 6

Figma Console Mcp96

MCP server for accessing Figma plugin console logs and screenshots via Cloudflare Workers or local mode

1.7k 2

MCP Security Weekly

Get CVE alerts and security updates for UnityMCP and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Developer Tools Entertainment

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unity-mcp": {
      "args": [
        "path/to/index.js"
      ],
      "command": "node"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/unitymcp)](https://mcppedia.org/s/unitymcp)

Read me

What UnityMCP does

Test This Server

This server supports HTTP transport. Be the first to test it — help the community know if it works.

README

Unity MCP 統合フレームワーク

English Version

Unity Editor と Model Context Protocol (MCP) を統合する拡張フレームワークです。Claude などの AI 言語モデル、または CLI (curl) から、HTTP 経由で Unity Editor を直接操作できます。

🌟 特徴 (v2.1)

HTTP + UDP アーキテクチャ: 各 Unity Editor が HTTP サーバを持ち、UDP ブロードキャストで自動 discovery
MCP と HTTP の両方をサポート: Claude Desktop / Claude Code からは MCP tool 経由、スクリプト / CI からは curl 直叩き
マルチ Editor 対応: 複数 Unity Editor を同時起動しても target パラメータ or プロキシで名前指定ルーティング
ドメインリロード耐性: SessionState で port を永続化し、リロード跨ぎで同 port を自動再バインド
Editor パネルキャプチャ (Windows): Inspector / Hierarchy / Project / Console などの任意 EditorWindow をスクリーンショット
built-in コード実行: HTTP /execute_code と MCP tool unity_execute_code が標準装備 (Roslyn 使用)
拡張可能なプラグインアーキテクチャ: IMcpCommandHandler / IMcpResourceHandler / BasePromptHandler を実装すればリフレクションで自動登録
統一レスポンスエンベロープ: {status, result?, error?, truncated?, next?} で成功/エラー/ページングを一貫した形で返す
コンテキスト経済: limit / offset / fields / detail パラメータでレスポンスを絞り込み可能
冪等性分類: Safe / Unsafe を per-action で宣言し、TS 側が err.cause.code を見て再送可否を制御 (副作用操作の二重実行を構造的に排除)

📋 必要条件

Unity 2022.3 以上 (Unity 6000 系対応)
- 2022.3.22f1、2023.2.19f1、6000.0.35f1、6000.1.17f1 で動作確認
.NET / C# 9.0
Node.js 18.0.0 以上 (TypeScript MCP サーバ用)
- Node.js 公式サイトから入手

🚀 はじめに

インストール方法

Unity パッケージマネージャからインストール:

Window > Package Manager を開く
「+」 → 「Add package from git URL...」
https://github.com/isuzu-shiranui/UnityMCP.git?path=jp.shiranui-isuzu.unity-mcp を入力

クイックセットアップ

Unity Editor を起動すると、McpEditorInitializer が自動的に HTTP サーバを立ち上げます (127.0.0.1:27182、27182-27199 でフォールバック)
Edit > Preferences > Unity MCP で設定を確認
curl http://127.0.0.1:27182/health で動作確認

Claude Desktop / Claude Code との連携

インストーラーを使う場合

Unity Editor で Edit > Preferences > Unity MCP を開く
「Open Installer Window」をクリック
インストーラーの指示に従い、Node.js の存在確認後、TypeScript クライアントをダウンロード
「Configuration Preview」セクションの JSON をクリップボードへコピー
Claude Desktop の Settings > Developer > Edit Config で貼り付けて保存
Claude Desktop を再起動

💡 macOS 利用者へ: v2.1 で Homebrew 経由の Node (/opt/homebrew/bin/node、/usr/local/bin/node) の検出に対応しました。Finder から起動した Unity が PATH を継承しない環境でも動作します (#7)。

手動でインストールする場合

unity-mcp-ts リポジトリをクローン or リリース ZIP を取得
npm install && npm run build を実行して build/index.js を生成
Claude Desktop の claude_desktop_config.json に追加:

{
  "mcpServers": {
    "unity-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/unity-mcp-ts/build/index.js"]
    }
  }
}

Windows ではパスのバックスラッシュをエスケープ (\\) するか、フォワードスラッシュを使ってください。

CLI (curl) でも使える

TypeScript サーバ不要で、HTTP 直叩きから操作可能:

# ヘルスチェック
curl http://127.0.0.1:27182/health

# C# コード実行
curl -X POST http://127.0.0.1:27182/execute_code \
  -H "Content-Type: application/json" \
  -d '{"code":"return GameObject.FindObjectsByType<Transform>(FindObjectsSortMode.None).Length;"}'

# Inspector のスクショ (Windows)
curl -X POST http://127.0.0.1:27182/capture_screenshot \
  -H "Content-Type: application/json" \
  -d '{"view":"inspector","maxSize":1024}'

マルチ Editor 用にプロキシ経由の例:

# 複数 Unity が起動中なら TS サーバの :27180 で discover
curl http://127.0.0.1:27180/projects

# プロジェクト名指定でリクエスト転送
curl -X POST http://127.0.0.1:27180/proxy/MyProject/health

Skill として ~/.claude/skills/unity-mcp/ に curl ワークフロー集を同梱しています。

🔌 アーキテクチャ (v2.1)

MCP client (Claude)
    │ stdio (MCP protocol)
    ▼
unity-mcp-ts (Node)
    ├── HandlerAdapter / HandlerDiscovery  (MCP tools / prompts / resources)
    ├── UnityConnection      

... [View full README on GitHub](https://github.com/isuzu-shiranui/UnityMCP#readme)

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

65/100across 5 weighted dimensions

How we score →

0255075100

−35

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (10)

Click any tool to inspect its schema.

~536 tokens total

Inventory

Resources (7)

health

Version, handler list, and uptime information

unity://health

hierarchy

Scene hierarchy with filtering support (limit/offset/fields)

unity://hierarchy

inspect

GameObject and Component property inspection and manipulation

unity://inspect

screenshot

Capture Game, Scene, or Editor panel screenshots (inspector/hierarchy/project/console)

unity://screenshot

logs

Console logs retrieval with filtering

unity://logs

play_mode

Play Mode control (status/play/stop/pause/unpause/step)

unity://play_mode

resource

Assemblies and packages information

unity://resource

Inventory

Prompts (1)

code_execute

C# code template for unity_execute_code tool

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is UnityMCP safe to use?: UnityMCP has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install UnityMCP?: UnityMCP supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can UnityMCP do?: UnityMCP provides 10 tools: unity_listClients, unity_setActiveClient, unity_connectToProject, unity_getActiveClient, unity_execute_code and 5 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with UnityMCP?: UnityMCP is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is UnityMCP actively maintained?: UnityMCP is recently maintained — last commit was 35 days ago. It has 132 GitHub stars.