# GladeKit Unity MCP — Connect AI Clients to Unity

> GladeKit Unity MCP connects Cursor/Claude Code to Unity Editor; verified 121★. Install the Unity bridge (localhost:8765), then use `uvx gladekit-mcp`.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
# Unity: Package Manager -> Add package from git URL:
echo "https://github.com/Glade-tool/glade-mcp-unity.git?path=/unity-bridge"
# Claude Code MCP (recommended one-liner):
claude mcp add --transport stdio gladekit-unity --scope user -- uvx gladekit-mcp
# Then talk to your Unity Editor via MCP tools.
```

## Intro

GladeKit Unity MCP connects Cursor/Claude Code to Unity Editor; verified 121★. Install the Unity bridge (localhost:8765), then use `uvx gladekit-mcp`.

**Best for:** Unity teams who want AI clients to read/modify scenes, scripts, and assets through real editor tools

**Works with:** Unity Package Manager (git URL), MCP clients (Claude Code/Cursor/etc.), uv/uvx Python tool runner

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub: 121 stars · 22 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `uvx gladekit-mcp`.

## Main

- Install the Unity bridge first (it auto-starts on localhost:8765), then connect an MCP client using `uvx gladekit-mcp` per README.

- Treat tool count and discovery as part of workflow: README claims 235+ tools and suggests `get_relevant_tools` for extended categories.

- If `uvx` isn’t found (common on Windows/Unity PATH), README suggests using `pip install gladekit-mcp` and running `python -m gladekit_mcp` instead.

### Source-backed notes

- README shows Unity git package install URL with `?path=/unity-bridge` and says the bridge runs on `localhost:8765`.
- README provides Claude Code one-liner: `claude mcp add ... -- uvx gladekit-mcp` and JSON snippets for other clients.
- README includes a troubleshooting note about PATH and a fallback to `pip install gladekit-mcp` + `python -m gladekit_mcp`.

### FAQ

- **What runs inside Unity vs outside?**: README says Unity runs a bridge package; your AI client launches the MCP server via uvx/pip.
- **Which clients are supported?**: README lists Claude Code, Cursor, Windsurf, Claude Desktop, VS Code, and Unity AI Gateway config examples.
- **What’s the common failure mode?**: README calls out PATH differences (Unity vs terminal) and suggests adding PATH or switching to python -m mode.

## Source & Thanks

> Source: https://github.com/Glade-tool/glade-mcp-unity
> License: MIT
> GitHub stars: 121 · forks: 22

---

<!-- ZH -->

## Quick Use

```bash
# Unity: Package Manager -> Add package from git URL:
echo "https://github.com/Glade-tool/glade-mcp-unity.git?path=/unity-bridge"
# Claude Code MCP (recommended one-liner):
claude mcp add --transport stdio gladekit-unity --scope user -- uvx gladekit-mcp
# Then talk to your Unity Editor via MCP tools.
```

## Intro

GladeKit Unity MCP 可让 Cursor/Claude Code 直接连接 Unity 编辑器；已验证 121★，Unity bridge 默认在 localhost:8765 启动，并用 `uvx gladekit-mcp` 提供 MCP 服务。

**Best for:** 希望让 AI 通过真实编辑器工具读写场景/脚本/资源的 Unity 团队

**Works with:** Unity Package Manager（git URL）、MCP 客户端（Claude Code/Cursor 等）、uv/uvx Python 运行器

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub：121 stars · 22 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口命令：`uvx gladekit-mcp`。

## Main

- 先安装 Unity bridge（README 说会在 localhost:8765 自动启动），再按 README 用 `uvx gladekit-mcp` 接入 MCP 客户端。

- 把工具发现当作流程的一部分：README 宣称 235+ tools，并建议用 `get_relevant_tools` 做扩展工具发现。

- 如果 Unity/系统找不到 `uvx`（常见于 PATH 不一致），README 建议改用 `pip install gladekit-mcp`，并以 `python -m gladekit_mcp` 运行。

### Source-backed notes

- README 给出 Unity git package 安装 URL（`?path=/unity-bridge`），并表示 bridge 在 `localhost:8765` 运行。
- README 提供 Claude Code 一行接入：`claude mcp add ... -- uvx gladekit-mcp`，并给出其他客户端的 JSON 配置片段。
- README 提供 PATH 排查与 fallback：`pip install gladekit-mcp` + `python -m gladekit_mcp`。

### FAQ

- **Unity 内外分别跑什么？**：README 表示 Unity 内安装 bridge 包；AI 客户端侧通过 uvx/pip 启动 MCP server。
- **支持哪些客户端？**：README 列出 Claude Code、Cursor、Windsurf、Claude Desktop、VS Code 以及 Unity AI Gateway 的配置示例。
- **最常见失败原因是什么？**：README 指出 Unity 的 PATH 与终端不同，建议补 PATH 或切换到 python -m 的方式运行。

## Source & Thanks

> Source: https://github.com/Glade-tool/glade-mcp-unity
> License: MIT
> GitHub stars: 121 · forks: 22


---
Source: https://tokrepo.com/en/workflows/gladekit-unity-mcp-connect-ai-clients-to-unity
Author: MCP Hub