UnityNaturalMCP
UnityNaturalMCP is an MCP server implementation for Unity that aims for a 'natural' user experience.
What is UnityNaturalMCP?
UnityNaturalMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unitynaturalmcp is an mcp server implementation for unity that aims for a 'natural' user experience.
UnityNaturalMCP is an MCP server implementation for Unity that aims for a 'natural' user experience.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- UnityNaturalMCP is an MCP server implementation for Unity th
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx unitynaturalmcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use UnityNaturalMCP
UnityNaturalMCP is an MCP server implementation that runs inside the Unity Editor and exposes built-in tools for refreshing assets, reading console logs, clearing logs, and running Edit Mode or Play Mode tests via Unity Test Runner. It communicates over HTTP on localhost port 56780 so that any MCP-capable AI assistant—Claude Code, Cursor, GitHub Copilot, or Gemini CLI—can query and control the Unity Editor in real time. The project prioritizes a 'natural' developer experience by letting you install the server directly from the Unity Package Manager using a Git URL.
Prerequisites
- Unity Editor 2022.3 LTS or newer installed
- Git installed (required by Unity Package Manager for Git URL installs)
- An MCP-capable client: Claude Code, Cursor, VS Code with GitHub Copilot, or Gemini CLI
- Node.js (only if using Claude Code or npx-based client integration)
- No API keys required — the server runs entirely on localhost
Add the package via Unity Package Manager
Open your Unity project, go to Window > Package Manager, click the '+' button, select 'Add package from git URL', and enter the UnityNaturalMCP Git URL.
https://github.com/notargs/UnityNaturalMCP.git?path=/UnityNaturalMCPServerOr add the dependency directly to manifest.json
Alternatively, open Packages/manifest.json in your project and add the dependency entry manually.
{
"dependencies": {
"jp.notargs.unity-natural-mcp": "https://github.com/notargs/UnityNaturalMCP.git?path=/UnityNaturalMCPServer"
}
}Start the MCP server from the Unity Editor
After package installation, the MCP server starts automatically when you open the Unity Editor. It listens on HTTP at http://localhost:56780/mcp.
Connect Claude Code to the running server
Register the local HTTP transport with Claude Code using the mcp add command. This adds the server to your project's MCP configuration.
claude mcp add -s project --transport http unity-natural-mcp http://localhost:56780/mcpConnect Cursor to the server
Add a Cursor MCP config entry pointing at localhost. Cursor reads MCP_SERVER_IP and MCP_SERVER_PORT from the environment or your MCP settings file.
{
"mcpServers": {
"unity-natural-mcp": {
"url": "http://localhost:56780/mcp"
}
}
}UnityNaturalMCP Examples
Client configuration (Claude Code project)
Register UnityNaturalMCP as an HTTP transport server within your Claude Code project scope.
{
"mcpServers": {
"unity-natural-mcp": {
"type": "http",
"url": "http://localhost:56780/mcp"
}
}
}Prompts to try
These prompts leverage the five built-in MCP tools exposed by UnityNaturalMCP.
- "Refresh all assets in the Unity Editor"
- "Show me the current Unity console logs"
- "Clear the Unity console"
- "Run all Edit Mode tests and report results"
- "Run Play Mode tests for the GameplayTests assembly"Troubleshooting UnityNaturalMCP
Claude Code or Cursor cannot connect to the MCP server
Confirm the Unity Editor is open and the package is installed correctly. The HTTP server only runs while the Editor is active. Check that nothing else is using port 56780.
Package Manager fails to install from the Git URL
Ensure Git is installed and on your PATH. Unity Package Manager uses Git directly for URL installs. Run 'git --version' in a terminal to verify.
Custom tools are not appearing in the AI assistant
Custom tools require implementing a class with [McpServerToolType] and a builder inheriting McpBuilderScriptableObject, then instantiating the builder as a ScriptableObject in the Editor. Restart the Editor after creating a new builder asset.
Frequently Asked Questions about UnityNaturalMCP
What is UnityNaturalMCP?
UnityNaturalMCP is a Model Context Protocol (MCP) server that unitynaturalmcp is an mcp server implementation for unity that aims for a 'natural' user experience. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install UnityNaturalMCP?
Follow the installation instructions on the UnityNaturalMCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with UnityNaturalMCP?
UnityNaturalMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is UnityNaturalMCP free to use?
Yes, UnityNaturalMCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
UnityNaturalMCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to UnityNaturalMCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up UnityNaturalMCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use UnityNaturalMCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.