mcpforunityserver 8.2.3__tar.gz → 8.3.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {mcpforunityserver-8.2.3/src/MCPForUnityServer.egg-info → mcpforunityserver-8.3.0}/PKG-INFO +37 -65
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/README.md +35 -63
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/pyproject.toml +3 -3
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0/src/mcpforunityserver.egg-info}/PKG-INFO +37 -65
- {mcpforunityserver-8.2.3/src/MCPForUnityServer.egg-info → mcpforunityserver-8.3.0/src/mcpforunityserver.egg-info}/SOURCES.txt +0 -6
- {mcpforunityserver-8.2.3/src/MCPForUnityServer.egg-info → mcpforunityserver-8.3.0/src/mcpforunityserver.egg-info}/requires.txt +1 -1
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/LICENSE +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/setup.cfg +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/core/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/core/config.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/core/logging_decorator.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/core/telemetry.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/core/telemetry_decorator.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/main.py +0 -0
- {mcpforunityserver-8.2.3/src/MCPForUnityServer.egg-info → mcpforunityserver-8.3.0/src/mcpforunityserver.egg-info}/dependency_links.txt +0 -0
- {mcpforunityserver-8.2.3/src/MCPForUnityServer.egg-info → mcpforunityserver-8.3.0/src/mcpforunityserver.egg-info}/entry_points.txt +0 -0
- {mcpforunityserver-8.2.3/src/MCPForUnityServer.egg-info → mcpforunityserver-8.3.0/src/mcpforunityserver.egg-info}/top_level.txt +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/models/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/models/models.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/models/unity_response.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/routes/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/custom_tool_service.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/registry/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/registry/resource_registry.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/registry/tool_registry.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/active_tool.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/custom_tools.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/editor_state.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/layers.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/menu_items.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/prefab_stage.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/project_info.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/selection.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/tags.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/tests.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/unity_instances.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/windows.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/batch_execute.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/debug_request_context.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/execute_custom_tool.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/execute_menu_item.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/find_in_file.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_asset.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_editor.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_gameobject.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_material.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_prefabs.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_scene.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_script.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/manage_shader.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/read_console.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/run_tests.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/script_apply_edits.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/set_active_instance.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/utils.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/__init__.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/legacy/port_discovery.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/legacy/stdio_port_registry.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/legacy/unity_connection.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/models.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/plugin_hub.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/plugin_registry.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/unity_instance_middleware.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/unity_transport.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/utils/module_discovery.py +0 -0
- {mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/utils/reload_sentinel.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: mcpforunityserver
|
|
3
|
-
Version: 8.
|
|
3
|
+
Version: 8.3.0
|
|
4
4
|
Summary: MCP for Unity Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP).
|
|
5
5
|
Author-email: Marcus Sanatan <msanatan@gmail.com>, David Sarno <david.sarno@gmail.com>, Wu Shutong <martinwfire@gmail.com>
|
|
6
6
|
License-Expression: MIT
|
|
@@ -28,7 +28,7 @@ License-File: LICENSE
|
|
|
28
28
|
Requires-Dist: httpx>=0.27.2
|
|
29
29
|
Requires-Dist: fastmcp<2.13.2,>=2.13.0
|
|
30
30
|
Requires-Dist: mcp>=1.16.0
|
|
31
|
-
Requires-Dist: pydantic>=2.12.
|
|
31
|
+
Requires-Dist: pydantic>=2.12.5
|
|
32
32
|
Requires-Dist: tomli>=2.3.0
|
|
33
33
|
Requires-Dist: fastapi>=0.104.0
|
|
34
34
|
Requires-Dist: uvicorn>=0.35.0
|
|
@@ -50,24 +50,20 @@ Model Context Protocol server for Unity Editor integration. Control Unity throug
|
|
|
50
50
|
|
|
51
51
|
💬 **Join our community:** [Discord Server](https://discord.gg/y4p8KfzrN4)
|
|
52
52
|
|
|
53
|
-
**Required:** Install the [Unity MCP Plugin](https://github.com/CoplayDev/unity-mcp?tab=readme-ov-file#-step-1-install-the-unity-package) to connect Unity Editor with this MCP server.
|
|
53
|
+
**Required:** Install the [Unity MCP Plugin](https://github.com/CoplayDev/unity-mcp?tab=readme-ov-file#-step-1-install-the-unity-package) to connect Unity Editor with this MCP server. You also need `uvx` (requires [uv](https://docs.astral.sh/uv/)) to run the server.
|
|
54
54
|
|
|
55
55
|
---
|
|
56
56
|
|
|
57
57
|
## Installation
|
|
58
58
|
|
|
59
|
-
### Option 1:
|
|
59
|
+
### Option 1: PyPI
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
Install and run directly from PyPI using `uvx`.
|
|
62
62
|
|
|
63
|
-
|
|
64
|
-
# HTTP (default)
|
|
65
|
-
uvx --from git+https://github.com/CoplayDev/unity-mcp@v8.2.3#subdirectory=Server \
|
|
66
|
-
mcp-for-unity --transport http --http-url http://localhost:8080
|
|
63
|
+
**Run Server (HTTP):**
|
|
67
64
|
|
|
68
|
-
|
|
69
|
-
uvx --from
|
|
70
|
-
mcp-for-unity --transport stdio
|
|
65
|
+
```bash
|
|
66
|
+
uvx --from mcpforunityserver mcp-for-unity --transport http --http-url http://localhost:8080
|
|
71
67
|
```
|
|
72
68
|
|
|
73
69
|
**MCP Client Configuration (HTTP):**
|
|
@@ -91,55 +87,29 @@ uvx --from git+https://github.com/CoplayDev/unity-mcp@v8.2.3#subdirectory=Server
|
|
|
91
87
|
"command": "uvx",
|
|
92
88
|
"args": [
|
|
93
89
|
"--from",
|
|
94
|
-
"
|
|
90
|
+
"mcpforunityserver",
|
|
95
91
|
"mcp-for-unity",
|
|
96
92
|
"--transport",
|
|
97
93
|
"stdio"
|
|
98
|
-
]
|
|
99
|
-
"type": "stdio"
|
|
94
|
+
]
|
|
100
95
|
}
|
|
101
96
|
}
|
|
102
97
|
}
|
|
103
98
|
```
|
|
104
99
|
|
|
105
|
-
### Option 2:
|
|
106
|
-
|
|
107
|
-
For local development or custom installations:
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
# Clone the repository
|
|
111
|
-
git clone https://github.com/CoplayDev/unity-mcp.git
|
|
112
|
-
cd unity-mcp/Server
|
|
113
|
-
|
|
114
|
-
# Run with uv (HTTP)
|
|
115
|
-
uv run server.py --transport http --http-url http://localhost:8080
|
|
116
|
-
|
|
117
|
-
# Run with uv (stdio)
|
|
118
|
-
uv run server.py --transport stdio
|
|
119
|
-
```
|
|
100
|
+
### Option 2: From GitHub Source
|
|
120
101
|
|
|
121
|
-
|
|
122
|
-
```json
|
|
123
|
-
{
|
|
124
|
-
"mcpServers": {
|
|
125
|
-
"UnityMCP": {
|
|
126
|
-
"url": "http://localhost:8080/mcp"
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
```
|
|
102
|
+
Use this to run the latest released version from the repository. Change the version to `main` to run the latest unreleased changes from the repository.
|
|
131
103
|
|
|
132
|
-
**MCP Client Configuration (stdio – Windows):**
|
|
133
104
|
```json
|
|
134
105
|
{
|
|
135
106
|
"mcpServers": {
|
|
136
107
|
"UnityMCP": {
|
|
137
|
-
"command": "
|
|
108
|
+
"command": "uvx",
|
|
138
109
|
"args": [
|
|
139
|
-
"
|
|
140
|
-
"
|
|
141
|
-
"
|
|
142
|
-
"server.py",
|
|
110
|
+
"--from",
|
|
111
|
+
"git+https://github.com/CoplayDev/unity-mcp@v8.3.0#subdirectory=Server",
|
|
112
|
+
"mcp-for-unity",
|
|
143
113
|
"--transport",
|
|
144
114
|
"stdio"
|
|
145
115
|
]
|
|
@@ -148,33 +118,35 @@ uv run server.py --transport stdio
|
|
|
148
118
|
}
|
|
149
119
|
```
|
|
150
120
|
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
"args": [
|
|
158
|
-
"run",
|
|
159
|
-
"--directory",
|
|
160
|
-
"/path/to/unity-mcp/Server",
|
|
161
|
-
"server.py",
|
|
162
|
-
"--transport",
|
|
163
|
-
"stdio"
|
|
164
|
-
]
|
|
165
|
-
}
|
|
166
|
-
}
|
|
167
|
-
}
|
|
121
|
+
### Option 3: Docker
|
|
122
|
+
|
|
123
|
+
**Use Pre-built Image:**
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
docker run -p 8080:8080 msanatan/mcp-for-unity-server:latest --transport http --http-url http://0.0.0.0:8080
|
|
168
127
|
```
|
|
169
128
|
|
|
170
|
-
|
|
129
|
+
**Build Locally:**
|
|
171
130
|
|
|
172
131
|
```bash
|
|
173
132
|
docker build -t unity-mcp-server .
|
|
174
133
|
docker run -p 8080:8080 unity-mcp-server --transport http --http-url http://0.0.0.0:8080
|
|
175
134
|
```
|
|
176
135
|
|
|
177
|
-
Configure your MCP client with `"url": "http://localhost:8080/mcp"`.
|
|
136
|
+
Configure your MCP client with `"url": "http://localhost:8080/mcp"`.
|
|
137
|
+
|
|
138
|
+
### Option 4: Local Development
|
|
139
|
+
|
|
140
|
+
For contributing or modifying the server code:
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
# Clone the repository
|
|
144
|
+
git clone https://github.com/CoplayDev/unity-mcp.git
|
|
145
|
+
cd unity-mcp/Server
|
|
146
|
+
|
|
147
|
+
# Run with uv
|
|
148
|
+
uv run src/main.py --transport stdio
|
|
149
|
+
```
|
|
178
150
|
|
|
179
151
|
---
|
|
180
152
|
|
|
@@ -11,24 +11,20 @@ Model Context Protocol server for Unity Editor integration. Control Unity throug
|
|
|
11
11
|
|
|
12
12
|
💬 **Join our community:** [Discord Server](https://discord.gg/y4p8KfzrN4)
|
|
13
13
|
|
|
14
|
-
**Required:** Install the [Unity MCP Plugin](https://github.com/CoplayDev/unity-mcp?tab=readme-ov-file#-step-1-install-the-unity-package) to connect Unity Editor with this MCP server.
|
|
14
|
+
**Required:** Install the [Unity MCP Plugin](https://github.com/CoplayDev/unity-mcp?tab=readme-ov-file#-step-1-install-the-unity-package) to connect Unity Editor with this MCP server. You also need `uvx` (requires [uv](https://docs.astral.sh/uv/)) to run the server.
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
18
|
## Installation
|
|
19
19
|
|
|
20
|
-
### Option 1:
|
|
20
|
+
### Option 1: PyPI
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
Install and run directly from PyPI using `uvx`.
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
# HTTP (default)
|
|
26
|
-
uvx --from git+https://github.com/CoplayDev/unity-mcp@v8.2.3#subdirectory=Server \
|
|
27
|
-
mcp-for-unity --transport http --http-url http://localhost:8080
|
|
24
|
+
**Run Server (HTTP):**
|
|
28
25
|
|
|
29
|
-
|
|
30
|
-
uvx --from
|
|
31
|
-
mcp-for-unity --transport stdio
|
|
26
|
+
```bash
|
|
27
|
+
uvx --from mcpforunityserver mcp-for-unity --transport http --http-url http://localhost:8080
|
|
32
28
|
```
|
|
33
29
|
|
|
34
30
|
**MCP Client Configuration (HTTP):**
|
|
@@ -52,55 +48,29 @@ uvx --from git+https://github.com/CoplayDev/unity-mcp@v8.2.3#subdirectory=Server
|
|
|
52
48
|
"command": "uvx",
|
|
53
49
|
"args": [
|
|
54
50
|
"--from",
|
|
55
|
-
"
|
|
51
|
+
"mcpforunityserver",
|
|
56
52
|
"mcp-for-unity",
|
|
57
53
|
"--transport",
|
|
58
54
|
"stdio"
|
|
59
|
-
]
|
|
60
|
-
"type": "stdio"
|
|
55
|
+
]
|
|
61
56
|
}
|
|
62
57
|
}
|
|
63
58
|
}
|
|
64
59
|
```
|
|
65
60
|
|
|
66
|
-
### Option 2:
|
|
67
|
-
|
|
68
|
-
For local development or custom installations:
|
|
69
|
-
|
|
70
|
-
```bash
|
|
71
|
-
# Clone the repository
|
|
72
|
-
git clone https://github.com/CoplayDev/unity-mcp.git
|
|
73
|
-
cd unity-mcp/Server
|
|
74
|
-
|
|
75
|
-
# Run with uv (HTTP)
|
|
76
|
-
uv run server.py --transport http --http-url http://localhost:8080
|
|
77
|
-
|
|
78
|
-
# Run with uv (stdio)
|
|
79
|
-
uv run server.py --transport stdio
|
|
80
|
-
```
|
|
61
|
+
### Option 2: From GitHub Source
|
|
81
62
|
|
|
82
|
-
|
|
83
|
-
```json
|
|
84
|
-
{
|
|
85
|
-
"mcpServers": {
|
|
86
|
-
"UnityMCP": {
|
|
87
|
-
"url": "http://localhost:8080/mcp"
|
|
88
|
-
}
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
```
|
|
63
|
+
Use this to run the latest released version from the repository. Change the version to `main` to run the latest unreleased changes from the repository.
|
|
92
64
|
|
|
93
|
-
**MCP Client Configuration (stdio – Windows):**
|
|
94
65
|
```json
|
|
95
66
|
{
|
|
96
67
|
"mcpServers": {
|
|
97
68
|
"UnityMCP": {
|
|
98
|
-
"command": "
|
|
69
|
+
"command": "uvx",
|
|
99
70
|
"args": [
|
|
100
|
-
"
|
|
101
|
-
"
|
|
102
|
-
"
|
|
103
|
-
"server.py",
|
|
71
|
+
"--from",
|
|
72
|
+
"git+https://github.com/CoplayDev/unity-mcp@v8.3.0#subdirectory=Server",
|
|
73
|
+
"mcp-for-unity",
|
|
104
74
|
"--transport",
|
|
105
75
|
"stdio"
|
|
106
76
|
]
|
|
@@ -109,33 +79,35 @@ uv run server.py --transport stdio
|
|
|
109
79
|
}
|
|
110
80
|
```
|
|
111
81
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
"args": [
|
|
119
|
-
"run",
|
|
120
|
-
"--directory",
|
|
121
|
-
"/path/to/unity-mcp/Server",
|
|
122
|
-
"server.py",
|
|
123
|
-
"--transport",
|
|
124
|
-
"stdio"
|
|
125
|
-
]
|
|
126
|
-
}
|
|
127
|
-
}
|
|
128
|
-
}
|
|
82
|
+
### Option 3: Docker
|
|
83
|
+
|
|
84
|
+
**Use Pre-built Image:**
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
docker run -p 8080:8080 msanatan/mcp-for-unity-server:latest --transport http --http-url http://0.0.0.0:8080
|
|
129
88
|
```
|
|
130
89
|
|
|
131
|
-
|
|
90
|
+
**Build Locally:**
|
|
132
91
|
|
|
133
92
|
```bash
|
|
134
93
|
docker build -t unity-mcp-server .
|
|
135
94
|
docker run -p 8080:8080 unity-mcp-server --transport http --http-url http://0.0.0.0:8080
|
|
136
95
|
```
|
|
137
96
|
|
|
138
|
-
Configure your MCP client with `"url": "http://localhost:8080/mcp"`.
|
|
97
|
+
Configure your MCP client with `"url": "http://localhost:8080/mcp"`.
|
|
98
|
+
|
|
99
|
+
### Option 4: Local Development
|
|
100
|
+
|
|
101
|
+
For contributing or modifying the server code:
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
# Clone the repository
|
|
105
|
+
git clone https://github.com/CoplayDev/unity-mcp.git
|
|
106
|
+
cd unity-mcp/Server
|
|
107
|
+
|
|
108
|
+
# Run with uv
|
|
109
|
+
uv run src/main.py --transport stdio
|
|
110
|
+
```
|
|
139
111
|
|
|
140
112
|
---
|
|
141
113
|
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "mcpforunityserver"
|
|
3
|
-
version = "8.
|
|
3
|
+
version = "8.3.0"
|
|
4
4
|
description = "MCP for Unity Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP)."
|
|
5
|
-
license = "MIT"
|
|
6
5
|
readme = "README.md"
|
|
6
|
+
license = "MIT"
|
|
7
7
|
authors = [
|
|
8
8
|
{name = "Marcus Sanatan", email = "msanatan@gmail.com"},
|
|
9
9
|
{name = "David Sarno", email = "david.sarno@gmail.com"},
|
|
@@ -32,7 +32,7 @@ dependencies = [
|
|
|
32
32
|
"httpx>=0.27.2",
|
|
33
33
|
"fastmcp>=2.13.0,<2.13.2",
|
|
34
34
|
"mcp>=1.16.0",
|
|
35
|
-
"pydantic>=2.12.
|
|
35
|
+
"pydantic>=2.12.5",
|
|
36
36
|
"tomli>=2.3.0",
|
|
37
37
|
"fastapi>=0.104.0",
|
|
38
38
|
"uvicorn>=0.35.0",
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: mcpforunityserver
|
|
3
|
-
Version: 8.
|
|
3
|
+
Version: 8.3.0
|
|
4
4
|
Summary: MCP for Unity Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP).
|
|
5
5
|
Author-email: Marcus Sanatan <msanatan@gmail.com>, David Sarno <david.sarno@gmail.com>, Wu Shutong <martinwfire@gmail.com>
|
|
6
6
|
License-Expression: MIT
|
|
@@ -28,7 +28,7 @@ License-File: LICENSE
|
|
|
28
28
|
Requires-Dist: httpx>=0.27.2
|
|
29
29
|
Requires-Dist: fastmcp<2.13.2,>=2.13.0
|
|
30
30
|
Requires-Dist: mcp>=1.16.0
|
|
31
|
-
Requires-Dist: pydantic>=2.12.
|
|
31
|
+
Requires-Dist: pydantic>=2.12.5
|
|
32
32
|
Requires-Dist: tomli>=2.3.0
|
|
33
33
|
Requires-Dist: fastapi>=0.104.0
|
|
34
34
|
Requires-Dist: uvicorn>=0.35.0
|
|
@@ -50,24 +50,20 @@ Model Context Protocol server for Unity Editor integration. Control Unity throug
|
|
|
50
50
|
|
|
51
51
|
💬 **Join our community:** [Discord Server](https://discord.gg/y4p8KfzrN4)
|
|
52
52
|
|
|
53
|
-
**Required:** Install the [Unity MCP Plugin](https://github.com/CoplayDev/unity-mcp?tab=readme-ov-file#-step-1-install-the-unity-package) to connect Unity Editor with this MCP server.
|
|
53
|
+
**Required:** Install the [Unity MCP Plugin](https://github.com/CoplayDev/unity-mcp?tab=readme-ov-file#-step-1-install-the-unity-package) to connect Unity Editor with this MCP server. You also need `uvx` (requires [uv](https://docs.astral.sh/uv/)) to run the server.
|
|
54
54
|
|
|
55
55
|
---
|
|
56
56
|
|
|
57
57
|
## Installation
|
|
58
58
|
|
|
59
|
-
### Option 1:
|
|
59
|
+
### Option 1: PyPI
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
Install and run directly from PyPI using `uvx`.
|
|
62
62
|
|
|
63
|
-
|
|
64
|
-
# HTTP (default)
|
|
65
|
-
uvx --from git+https://github.com/CoplayDev/unity-mcp@v8.2.3#subdirectory=Server \
|
|
66
|
-
mcp-for-unity --transport http --http-url http://localhost:8080
|
|
63
|
+
**Run Server (HTTP):**
|
|
67
64
|
|
|
68
|
-
|
|
69
|
-
uvx --from
|
|
70
|
-
mcp-for-unity --transport stdio
|
|
65
|
+
```bash
|
|
66
|
+
uvx --from mcpforunityserver mcp-for-unity --transport http --http-url http://localhost:8080
|
|
71
67
|
```
|
|
72
68
|
|
|
73
69
|
**MCP Client Configuration (HTTP):**
|
|
@@ -91,55 +87,29 @@ uvx --from git+https://github.com/CoplayDev/unity-mcp@v8.2.3#subdirectory=Server
|
|
|
91
87
|
"command": "uvx",
|
|
92
88
|
"args": [
|
|
93
89
|
"--from",
|
|
94
|
-
"
|
|
90
|
+
"mcpforunityserver",
|
|
95
91
|
"mcp-for-unity",
|
|
96
92
|
"--transport",
|
|
97
93
|
"stdio"
|
|
98
|
-
]
|
|
99
|
-
"type": "stdio"
|
|
94
|
+
]
|
|
100
95
|
}
|
|
101
96
|
}
|
|
102
97
|
}
|
|
103
98
|
```
|
|
104
99
|
|
|
105
|
-
### Option 2:
|
|
106
|
-
|
|
107
|
-
For local development or custom installations:
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
# Clone the repository
|
|
111
|
-
git clone https://github.com/CoplayDev/unity-mcp.git
|
|
112
|
-
cd unity-mcp/Server
|
|
113
|
-
|
|
114
|
-
# Run with uv (HTTP)
|
|
115
|
-
uv run server.py --transport http --http-url http://localhost:8080
|
|
116
|
-
|
|
117
|
-
# Run with uv (stdio)
|
|
118
|
-
uv run server.py --transport stdio
|
|
119
|
-
```
|
|
100
|
+
### Option 2: From GitHub Source
|
|
120
101
|
|
|
121
|
-
|
|
122
|
-
```json
|
|
123
|
-
{
|
|
124
|
-
"mcpServers": {
|
|
125
|
-
"UnityMCP": {
|
|
126
|
-
"url": "http://localhost:8080/mcp"
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
```
|
|
102
|
+
Use this to run the latest released version from the repository. Change the version to `main` to run the latest unreleased changes from the repository.
|
|
131
103
|
|
|
132
|
-
**MCP Client Configuration (stdio – Windows):**
|
|
133
104
|
```json
|
|
134
105
|
{
|
|
135
106
|
"mcpServers": {
|
|
136
107
|
"UnityMCP": {
|
|
137
|
-
"command": "
|
|
108
|
+
"command": "uvx",
|
|
138
109
|
"args": [
|
|
139
|
-
"
|
|
140
|
-
"
|
|
141
|
-
"
|
|
142
|
-
"server.py",
|
|
110
|
+
"--from",
|
|
111
|
+
"git+https://github.com/CoplayDev/unity-mcp@v8.3.0#subdirectory=Server",
|
|
112
|
+
"mcp-for-unity",
|
|
143
113
|
"--transport",
|
|
144
114
|
"stdio"
|
|
145
115
|
]
|
|
@@ -148,33 +118,35 @@ uv run server.py --transport stdio
|
|
|
148
118
|
}
|
|
149
119
|
```
|
|
150
120
|
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
"args": [
|
|
158
|
-
"run",
|
|
159
|
-
"--directory",
|
|
160
|
-
"/path/to/unity-mcp/Server",
|
|
161
|
-
"server.py",
|
|
162
|
-
"--transport",
|
|
163
|
-
"stdio"
|
|
164
|
-
]
|
|
165
|
-
}
|
|
166
|
-
}
|
|
167
|
-
}
|
|
121
|
+
### Option 3: Docker
|
|
122
|
+
|
|
123
|
+
**Use Pre-built Image:**
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
docker run -p 8080:8080 msanatan/mcp-for-unity-server:latest --transport http --http-url http://0.0.0.0:8080
|
|
168
127
|
```
|
|
169
128
|
|
|
170
|
-
|
|
129
|
+
**Build Locally:**
|
|
171
130
|
|
|
172
131
|
```bash
|
|
173
132
|
docker build -t unity-mcp-server .
|
|
174
133
|
docker run -p 8080:8080 unity-mcp-server --transport http --http-url http://0.0.0.0:8080
|
|
175
134
|
```
|
|
176
135
|
|
|
177
|
-
Configure your MCP client with `"url": "http://localhost:8080/mcp"`.
|
|
136
|
+
Configure your MCP client with `"url": "http://localhost:8080/mcp"`.
|
|
137
|
+
|
|
138
|
+
### Option 4: Local Development
|
|
139
|
+
|
|
140
|
+
For contributing or modifying the server code:
|
|
141
|
+
|
|
142
|
+
```bash
|
|
143
|
+
# Clone the repository
|
|
144
|
+
git clone https://github.com/CoplayDev/unity-mcp.git
|
|
145
|
+
cd unity-mcp/Server
|
|
146
|
+
|
|
147
|
+
# Run with uv
|
|
148
|
+
uv run src/main.py --transport stdio
|
|
149
|
+
```
|
|
178
150
|
|
|
179
151
|
---
|
|
180
152
|
|
|
@@ -3,12 +3,6 @@ README.md
|
|
|
3
3
|
pyproject.toml
|
|
4
4
|
src/__init__.py
|
|
5
5
|
src/main.py
|
|
6
|
-
src/MCPForUnityServer.egg-info/PKG-INFO
|
|
7
|
-
src/MCPForUnityServer.egg-info/SOURCES.txt
|
|
8
|
-
src/MCPForUnityServer.egg-info/dependency_links.txt
|
|
9
|
-
src/MCPForUnityServer.egg-info/entry_points.txt
|
|
10
|
-
src/MCPForUnityServer.egg-info/requires.txt
|
|
11
|
-
src/MCPForUnityServer.egg-info/top_level.txt
|
|
12
6
|
src/core/__init__.py
|
|
13
7
|
src/core/config.py
|
|
14
8
|
src/core/logging_decorator.py
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/registry/resource_registry.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/resources/unity_instances.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/debug_request_context.py
RENAMED
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/execute_custom_tool.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/script_apply_edits.py
RENAMED
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/services/tools/set_active_instance.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/legacy/stdio_port_registry.py
RENAMED
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/legacy/unity_connection.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{mcpforunityserver-8.2.3 → mcpforunityserver-8.3.0}/src/transport/unity_instance_middleware.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|