开源MCP工具

Requirements

• Unity 2022 LTS or newer (Unity 6 fully supported)
• Node.js 18+ (for the MCP server)
• macOS, Windows, or Linux

---

Quick install

One command. It walks you through the rest:

npx @mosaicxr-ai/create-bridge

The installer:

1. Asks for your Unity project path (create one in Unity Hub first if you haven't — any empty Unity 2022 LTS+ or Unity 6 project works) 2. Asks which MCP client(s) to configure — Claude Code, Claude Desktop, Cursor, Gemini CLI, or OpenAI Codex (any combination) 3. Adds com.mosaic.bridge to the project's Packages/manifest.json 4. Writes the MCP server entry into each selected client's config

Then open the Unity project, wait for compile, restart your MCP client, and start prompting.

Scene-building intelligence + cross-LLM agents

The installer writes instruction files and specialist agents into your Unity project for every supported AI client:

All instruction files enforce:

- Interview before building — when you give a vague prompt like "make me a desert scene", the AI asks 4 targeted questions (scene type, geographic reference, scale, player perspective) before touching any tools. - Spatial coherence — every placed object Y is resolved from terrain/sample-height before placement. No more objects buried underground or floating in air. - Correct build order — terrain → textures → lighting → structures → vegetation → post-processing → camera.

Three specialist skill agents are installed following the bmad-method convention — written to both .claude/skills/ (Claude Code slash commands) and .agents/skills/ (universal, works with Cursor, Gemini, Codex, Windsurf, OpenCode):

To skip writing instruction files:

npx @mosaicxr-ai/create-bridge --skip-claude

To refresh after an update:

npx @mosaicxr-ai/create-bridge --force

Manual install (if you prefer)

Add to <UnityProject>/Packages/manifest.json:

{
  "dependencies": {
    "com.mosaic.bridge": "https://github.com/MosaicXR-AI/mosaic-bridge.git?path=/packages/com.mosaic.bridge"
  }
}

Then point your MCP client at:

{
  "mcpServers": {
    "mosaic-bridge": {
      "command": "npx",
      "args": ["-y", "@mosaicxr-ai/mcp-server", "--project-path", "/path/to/UnityProject"]
    }
  }
}

---

Unity package — install via file: reference in a test project's manifest.json

See TESTING.md (coming soon) for setup details.

Monorepo layout:

Running Unity tests requires opting in via `testables` in the consuming
project's `manifest.json`:

---