@chrrxs/robloxstudio-mcp 2.23.0 → 3.0.0
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.
- package/dist/index.js +1532 -4565
- package/package.json +6 -4
- package/studio-plugin/INSTALLATION.md +18 -14
- package/studio-plugin/MCPInspectorPlugin.rbxmx +203 -1959
- package/studio-plugin/MCPPlugin.rbxmx +203 -1959
- package/studio-plugin/src/modules/Communication.ts +16 -47
- package/studio-plugin/src/modules/Utils.ts +60 -2
- package/studio-plugin/src/modules/handlers/MetadataHandlers.ts +3 -261
- package/studio-plugin/src/modules/handlers/PropertyHandlers.ts +1 -130
- package/studio-plugin/src/modules/handlers/QueryHandlers.ts +9 -167
- package/studio-plugin/src/modules/handlers/ScriptHandlers.ts +64 -63
- package/studio-plugin/src/modules/handlers/TestHandlers.ts +13 -6
- package/studio-plugin/src/modules/handlers/BuildHandlers.ts +0 -481
- package/studio-plugin/src/modules/handlers/InstanceHandlers.ts +0 -380
package/package.json
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chrrxs/robloxstudio-mcp",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.0.0",
|
|
4
4
|
"description": "MCP server for testing, debugging, and controlling Roblox Studio from AI coding tools",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|
|
7
|
+
"engines": {
|
|
8
|
+
"node": ">=20"
|
|
9
|
+
},
|
|
7
10
|
"bin": {
|
|
8
11
|
"robloxstudio-mcp": "dist/index.js"
|
|
9
12
|
},
|
|
@@ -35,11 +38,10 @@
|
|
|
35
38
|
"url": "https://github.com/chrrxs/robloxstudio-mcp/issues"
|
|
36
39
|
},
|
|
37
40
|
"dependencies": {
|
|
38
|
-
"@modelcontextprotocol/
|
|
39
|
-
"
|
|
41
|
+
"@modelcontextprotocol/node": "^2.0.0",
|
|
42
|
+
"@modelcontextprotocol/server": "^2.0.0",
|
|
40
43
|
"express": "^4.18.2",
|
|
41
44
|
"node-fetch": "^3.3.2",
|
|
42
|
-
"uuid": "^9.0.1",
|
|
43
45
|
"ws": "^8.14.2"
|
|
44
46
|
},
|
|
45
47
|
"devDependencies": {
|
|
@@ -42,19 +42,19 @@ Complete your AI assistant integration with this easy-to-install Studio plugin.
|
|
|
42
42
|
|
|
43
43
|
## Setup & Configuration
|
|
44
44
|
|
|
45
|
-
###
|
|
46
|
-
**Game Settings** > **Security** > **"Allow HTTP Requests"**
|
|
45
|
+
### Optional: Allow third-party Creator Store assets
|
|
47
46
|
|
|
48
|
-
To preview or insert public Creator Store assets that you do not own,
|
|
49
|
-
|
|
47
|
+
To preview or insert public Creator Store assets that you do not own, enable
|
|
48
|
+
**"Allow Loading Third Party Assets"** under
|
|
49
|
+
**Game Settings** > **Security**.
|
|
50
50
|
Roblox disables this setting by default.
|
|
51
51
|
|
|
52
|
-
###
|
|
52
|
+
### 1. Activate the Plugin
|
|
53
53
|
**Plugins toolbar** > Click **"MCP Server"** button
|
|
54
54
|
- **Green status** = Connected and ready
|
|
55
55
|
- **Red status** = Disconnected (normal until MCP server runs)
|
|
56
56
|
|
|
57
|
-
###
|
|
57
|
+
### 2. Install MCP Server
|
|
58
58
|
Choose your AI assistant:
|
|
59
59
|
|
|
60
60
|
**For Claude Code:**
|
|
@@ -116,10 +116,6 @@ If you encounter issues, you may need to run it through `cmd`. Update your confi
|
|
|
116
116
|
- Restart Roblox Studio completely
|
|
117
117
|
- Check Output window for error messages
|
|
118
118
|
|
|
119
|
-
### "HTTP 403 Forbidden" Errors
|
|
120
|
-
- Enable "Allow HTTP Requests" in Game Settings > Security
|
|
121
|
-
- Verify MCP server is running (status should show connected)
|
|
122
|
-
|
|
123
119
|
### Plugin Shows "Disconnected"
|
|
124
120
|
- **Normal behavior** when MCP server isn't running
|
|
125
121
|
- Click "MCP Server" button to activate
|
|
@@ -132,10 +128,18 @@ If you encounter issues, you may need to run it through `cmd`. Update your confi
|
|
|
132
128
|
|
|
133
129
|
## Security & Privacy
|
|
134
130
|
|
|
135
|
-
- **Local
|
|
136
|
-
|
|
137
|
-
- **
|
|
138
|
-
|
|
131
|
+
- **Local bridge by default**: The plugin connects to `http://localhost:58741`
|
|
132
|
+
unless you explicitly configure another server URL.
|
|
133
|
+
- **Explicit tool access**: The full plugin can modify a place when a write tool
|
|
134
|
+
is called. Install the Inspector edition when you need read-only access.
|
|
135
|
+
- **Provider boundary**: Tool results pass through your configured MCP client.
|
|
136
|
+
Your AI provider's data-handling policy applies to content sent by that
|
|
137
|
+
client.
|
|
138
|
+
|
|
139
|
+
See the repository's
|
|
140
|
+
[configuration guide](../docs/configuration.md) for HTTP bridge authentication
|
|
141
|
+
and network settings. Report suspected vulnerabilities through the
|
|
142
|
+
[security policy](../SECURITY.md), not a public issue.
|
|
139
143
|
|
|
140
144
|
## Advanced Usage
|
|
141
145
|
|