@lolofuk123/rbx-mcp 0.2.0 → 0.2.1
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/README.md +28 -3
- package/dist/config.js +13 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -10,8 +10,13 @@ The Node/TS package published to npm as **`@lolofuk123/rbx-mcp`**. One process,
|
|
|
10
10
|
On startup it also **auto-installs** the bundled Studio plugin into the local
|
|
11
11
|
Plugins folder. See the repo [`README`](../README.md) for the big picture.
|
|
12
12
|
|
|
13
|
-
## Use with
|
|
13
|
+
## Use with any MCP client
|
|
14
14
|
|
|
15
|
+
rbx-mcp is **model-agnostic** — use Claude, GPT, or whatever model your host
|
|
16
|
+
drives. The host just needs to support a local **stdio** MCP server on the same
|
|
17
|
+
machine as Studio. The config differs slightly per host:
|
|
18
|
+
|
|
19
|
+
**Claude Desktop / Claude Code** — key `mcpServers`:
|
|
15
20
|
```json
|
|
16
21
|
{
|
|
17
22
|
"mcpServers": {
|
|
@@ -19,9 +24,25 @@ Plugins folder. See the repo [`README`](../README.md) for the big picture.
|
|
|
19
24
|
}
|
|
20
25
|
}
|
|
21
26
|
```
|
|
27
|
+
- Claude Desktop → `%APPDATA%\Claude\claude_desktop_config.json` (Windows) / `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
|
|
28
|
+
- Claude Code → `.mcp.json` at the project root, or `claude mcp add`
|
|
29
|
+
|
|
30
|
+
**VS Code / GitHub Copilot** (Agent mode) — different key (`servers`) and `type`;
|
|
31
|
+
file `.vscode/mcp.json` (or Command Palette → **MCP: Add Server**):
|
|
32
|
+
```json
|
|
33
|
+
{
|
|
34
|
+
"servers": {
|
|
35
|
+
"rbx-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@lolofuk123/rbx-mcp"] }
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
```
|
|
39
|
+
MCP tools only work in Copilot **Agent mode** (not Ask/Edit). On Windows you may
|
|
40
|
+
need the `cmd /c` wrapper — see Troubleshooting below. (Cursor / Windsurf use the
|
|
41
|
+
Claude-style `mcpServers` shape, e.g. `.cursor/mcp.json`.)
|
|
22
42
|
|
|
23
|
-
|
|
24
|
-
Studio so it loads the auto-installed plugin
|
|
43
|
+
The host launches the process — you never run a `start` command. Then start/restart
|
|
44
|
+
Studio so it loads the auto-installed plugin, open the **rbx-mcp** panel, and click
|
|
45
|
+
**Start**.
|
|
25
46
|
|
|
26
47
|
## Environment variables
|
|
27
48
|
|
|
@@ -76,4 +97,8 @@ into the local Plugins folder and restart Studio. See
|
|
|
76
97
|
- **Plugin not connected** — Studio open? plugin enabled + **Start**ed? HttpService
|
|
77
98
|
allowed? Host/Port/Token match the server?
|
|
78
99
|
- **Port in use** — set `RBXMCP_PORT` (and the plugin's Port field) to a free port.
|
|
100
|
+
- **VS Code / Copilot on Windows: `spawn npx ENOENT`** — Node must be installed and
|
|
101
|
+
VS Code fully restarted (it caches PATH at launch). On Windows, set the server
|
|
102
|
+
command to `cmd` with args `["/c","npx","-y","@lolofuk123/rbx-mcp"]` (or
|
|
103
|
+
`npx.cmd`). MCP tools only work in Copilot **Agent mode**.
|
|
79
104
|
- **Linux** — there's no standard Studio Plugins path; install manually.
|
package/dist/config.js
CHANGED
|
@@ -1,4 +1,16 @@
|
|
|
1
|
-
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { fileURLToPath } from "node:url";
|
|
3
|
+
/** Read the package version from package.json so /health never reports a stale, hardcoded value. */
|
|
4
|
+
function readPkgVersion() {
|
|
5
|
+
try {
|
|
6
|
+
const pkgUrl = new URL("../package.json", import.meta.url);
|
|
7
|
+
return JSON.parse(readFileSync(fileURLToPath(pkgUrl), "utf8")).version ?? "0.0.0";
|
|
8
|
+
}
|
|
9
|
+
catch {
|
|
10
|
+
return "0.0.0";
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
export const VERSION = readPkgVersion();
|
|
2
14
|
const LOG_LEVELS = ["error", "warn", "info", "debug"];
|
|
3
15
|
function clampInt(raw, def, min, max) {
|
|
4
16
|
if (raw === undefined || raw.trim() === "")
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lolofuk123/rbx-mcp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
7
|
-
"description": "
|
|
7
|
+
"description": "Execute Lua live inside Roblox Studio from any MCP client (Claude, Copilot, Cursor, ...) — write, run, read results, iterate.",
|
|
8
8
|
"type": "module",
|
|
9
9
|
"bin": {
|
|
10
10
|
"rbx-mcp": "dist/index.js"
|