@weppy/roblox-mcp 0.1.6 → 0.1.8
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/.claude-plugin/marketplace.json +3 -4
- package/CHANGELOG.md +3 -12
- package/docs/en/installation/roblox-plugin.md +0 -3
- package/docs/es/installation/roblox-plugin.md +0 -3
- package/docs/id/installation/roblox-plugin.md +0 -3
- package/docs/ja/installation/roblox-plugin.md +0 -3
- package/docs/ko/installation/roblox-plugin.md +0 -3
- package/docs/pt-br/installation/roblox-plugin.md +0 -3
- package/package.json +1 -1
- package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json +1 -1
- package/plugins/weppy-roblox-mcp/dist/index.js +1 -1
|
@@ -6,15 +6,14 @@
|
|
|
6
6
|
},
|
|
7
7
|
"metadata": {
|
|
8
8
|
"description": "Roblox MCP server and tools for AI-powered game development",
|
|
9
|
-
"version": "0.1.
|
|
10
|
-
"pluginRoot": "./plugins"
|
|
9
|
+
"version": "0.1.8"
|
|
11
10
|
},
|
|
12
11
|
"plugins": [
|
|
13
12
|
{
|
|
14
13
|
"name": "weppy-roblox-mcp",
|
|
15
|
-
"source": "./weppy-roblox-mcp",
|
|
14
|
+
"source": "./plugins/weppy-roblox-mcp",
|
|
16
15
|
"description": "MCP server for Roblox Studio integration - 132 tools for AI-powered game development with specialized agents and skills",
|
|
17
|
-
"version": "0.1.
|
|
16
|
+
"version": "0.1.8",
|
|
18
17
|
"author": {
|
|
19
18
|
"name": "hope1026"
|
|
20
19
|
},
|
package/CHANGELOG.md
CHANGED
|
@@ -3,24 +3,15 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
|
|
5
5
|
|
|
6
|
+
## [0.1.8] - 2026-02-08
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
### Other Changes
|
|
10
|
-
|
|
11
|
-
- refactor: improve stability
|
|
12
|
-
|
|
13
|
-
## [0.1.5] - 2026-02-07
|
|
14
|
-
|
|
15
|
-
### Other Changes
|
|
16
|
-
|
|
17
|
-
- update guide
|
|
8
|
+
### Fix
|
|
9
|
+
- improve stability
|
|
18
10
|
|
|
19
11
|
|
|
20
12
|
## [0.1.3] - 2026-02-07
|
|
21
13
|
|
|
22
14
|
### Features
|
|
23
|
-
|
|
24
15
|
- add tool history and statistics tracking system
|
|
25
16
|
- add version info display in plugin UI
|
|
26
17
|
|
|
@@ -44,9 +44,6 @@ The MCP server must be installed. Complete the guide for your AI app first:
|
|
|
44
44
|
1. Open any project in **Roblox Studio**
|
|
45
45
|
2. Go to **Plugins** tab → **W-MCP**
|
|
46
46
|
3. Click the **Connect** button in the plugin window
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
47
|
4. Once **"Connected"** status is displayed, you're ready!
|
|
51
48
|
|
|
52
49
|
|
|
@@ -44,9 +44,6 @@ El servidor MCP debe estar instalado. Completa primero la guia correspondiente a
|
|
|
44
44
|
1. Abre cualquier proyecto en **Roblox Studio**
|
|
45
45
|
2. Pestana **Plugins** superior → Clic en **W-MCP**
|
|
46
46
|
3. Clic en el boton **Connect** en la ventana del plugin
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
47
|
4. ¡Conexion completada cuando aparece el estado **"Connected"**!
|
|
51
48
|
|
|
52
49
|
|
|
@@ -44,9 +44,6 @@ MCP server harus sudah terinstal. Selesaikan panduan yang sesuai dengan aplikasi
|
|
|
44
44
|
1. Buka proyek apa saja di **Roblox Studio**
|
|
45
45
|
2. Tab **Plugins** di atas → Klik **W-MCP**
|
|
46
46
|
3. Klik tombol **Connect** di jendela plugin
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
47
|
4. Jika status **"Connected"** ditampilkan, koneksi berhasil!
|
|
51
48
|
|
|
52
49
|
|
|
@@ -44,9 +44,6 @@ MCPサーバーがインストールされている必要があります。お
|
|
|
44
44
|
1. **Roblox Studio**で任意のプロジェクトを開きます
|
|
45
45
|
2. 上部の **Plugins** タブ → **W-MCP** をクリック
|
|
46
46
|
3. プラグインウィンドウで **Connect** ボタンをクリック
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
47
|
4. **"Connected"** 状態が表示されたら接続完了！
|
|
51
48
|
|
|
52
49
|
|
|
@@ -44,9 +44,6 @@ MCP 서버가 설치되어 있어야 합니다. 사용하는 AI 앱에 맞는
|
|
|
44
44
|
1. **Roblox Studio**에서 아무 프로젝트를 엽니다
|
|
45
45
|
2. 상단 **Plugins** 탭 → **W-MCP** 클릭
|
|
46
46
|
3. 플러그인 창에서 **Connect** 버튼 클릭
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
47
|
4. **"Connected"** 상태가 표시되면 연결 완료!
|
|
51
48
|
|
|
52
49
|
|
|
@@ -44,9 +44,6 @@ O servidor MCP deve estar instalado. Complete primeiro o guia correspondente ao
|
|
|
44
44
|
1. Abra qualquer projeto no **Roblox Studio**
|
|
45
45
|
2. Aba **Plugins** no topo → Clique em **W-MCP**
|
|
46
46
|
3. Clique no botao **Connect** na janela do plugin
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
47
|
4. Quando aparecer o status **"Connected"**, a conexao foi estabelecida!
|
|
51
48
|
|
|
52
49
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@weppy/roblox-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.8",
|
|
4
4
|
"description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
|
|
5
5
|
"main": "plugins/weppy-roblox-mcp/dist/index.js",
|
|
6
6
|
"type": "module",
|
|
@@ -145,7 +145,7 @@ Basic tier users cannot use Pro tools - they will receive a friendly message sug
|
|
|
145
145
|
Stack: ${e.stack}`;if(typeof e=="object")try{return`
|
|
146
146
|
`+JSON.stringify(e,null,2).replace(/\n/g,`
|
|
147
147
|
`)}catch{return`
|
|
148
|
-
[Circular or non-serializable object]`}return` ${String(e)}`}static log(e,r,n){if(!this.shouldLog(e))return;let i=this.getTimestamp(),a=up[e],o=this.formatData(n),s=`${up.gray}[${i}]${up.reset} ${a}[${e.toUpperCase()}]${up.reset} ${r}${o}`;console.error(s)}static debug(e,r){this.log("debug",e,r)}static info(e,r){this.log("info",e,r)}static warn(e,r){this.log("warn",e,r)}static error(e,r){this.log("error",e,r)}},S=ox;var RB=new Set(["ping","echo","get_info","get_usage_status","create_instance","delete_instance","clone_instance","move_instance","get_instance","get_instance_children","rename_instance","find_first_child","find_first_descendant","create_instance_with_properties","get_class_info","wait_for_child","pivot_to","create_script","get_script_source","set_script_source","read_script","update_script","delete_script","edit_script_lines","insert_script_lines","delete_script_lines","search_in_scripts","get_script_dependencies","get_property","set_property","get_properties","set_properties","get_all_properties","set_multiple_properties","set_calculated_property","set_relative_property","get_attribute","set_attribute","get_all_attributes","delete_attribute","find_by_name","search_by_name","search_by_class","get_selection","get_selection_context","get_selection_details","set_selection","clear_selection","add_to_selection","remove_from_selection","get_place_info","get_services","get_studio_settings","run_command","watch_selection","add_tag","remove_tag","get_tags","get_tagged","has_tag","get_camera_info","get_suggested_camera_view","focus_camera_path","focus_camera_position","get_output_logs","clear_output_logs","get_recent_errors"]),CB=60*1e3,lp=null;function pp(t){return RB.has(t)?"basic":"pro"}function zP(t){lp={...t,timestamp:Date.now()}}function DB(){return!lp||Date.now()-lp.timestamp>CB?null:lp}function TP(t){if(pp(t)==="basic")return{allowed:!0,tier:"basic"};let r=DB();if(!r)return{allowed:!0,tier:"pro"};if(r.tier==="pro")return{allowed:!0,tier:"pro"};if(r.remaining<=0){let n=Math.floor(r.resetIn/3600),i=Math.floor(r.resetIn%3600/60);return{allowed:!1,tier:"pro",remaining:0,error:`Pro tool quota exhausted (${r.used}/${r.limit}). Resets in ${n}h ${i}m. Use basic alternatives or upgrade to Pro.`}}return{allowed:!0,tier:"pro",remaining:r.remaining}}var At="0.1.
|
|
148
|
+
[Circular or non-serializable object]`}return` ${String(e)}`}static log(e,r,n){if(!this.shouldLog(e))return;let i=this.getTimestamp(),a=up[e],o=this.formatData(n),s=`${up.gray}[${i}]${up.reset} ${a}[${e.toUpperCase()}]${up.reset} ${r}${o}`;console.error(s)}static debug(e,r){this.log("debug",e,r)}static info(e,r){this.log("info",e,r)}static warn(e,r){this.log("warn",e,r)}static error(e,r){this.log("error",e,r)}},S=ox;var RB=new Set(["ping","echo","get_info","get_usage_status","create_instance","delete_instance","clone_instance","move_instance","get_instance","get_instance_children","rename_instance","find_first_child","find_first_descendant","create_instance_with_properties","get_class_info","wait_for_child","pivot_to","create_script","get_script_source","set_script_source","read_script","update_script","delete_script","edit_script_lines","insert_script_lines","delete_script_lines","search_in_scripts","get_script_dependencies","get_property","set_property","get_properties","set_properties","get_all_properties","set_multiple_properties","set_calculated_property","set_relative_property","get_attribute","set_attribute","get_all_attributes","delete_attribute","find_by_name","search_by_name","search_by_class","get_selection","get_selection_context","get_selection_details","set_selection","clear_selection","add_to_selection","remove_from_selection","get_place_info","get_services","get_studio_settings","run_command","watch_selection","add_tag","remove_tag","get_tags","get_tagged","has_tag","get_camera_info","get_suggested_camera_view","focus_camera_path","focus_camera_position","get_output_logs","clear_output_logs","get_recent_errors"]),CB=60*1e3,lp=null;function pp(t){return RB.has(t)?"basic":"pro"}function zP(t){lp={...t,timestamp:Date.now()}}function DB(){return!lp||Date.now()-lp.timestamp>CB?null:lp}function TP(t){if(pp(t)==="basic")return{allowed:!0,tier:"basic"};let r=DB();if(!r)return{allowed:!0,tier:"pro"};if(r.tier==="pro")return{allowed:!0,tier:"pro"};if(r.remaining<=0){let n=Math.floor(r.resetIn/3600),i=Math.floor(r.resetIn%3600/60);return{allowed:!1,tier:"pro",remaining:0,error:`Pro tool quota exhausted (${r.used}/${r.limit}). Resets in ${n}h ${i}m. Use basic alternatives or upgrade to Pro.`}}return{allowed:!0,tier:"pro",remaining:r.remaining}}var At="0.1.8";var lx=class{app;server=null;config;commandQueue=new Map;pendingCommands=new Map;globalPendingCommands=[];sseClients=new Set;startTime=Date.now();requestCounts=new Map;cachedSelection=null;isClientMode=!1;baseUrl="";instanceId=Rr();sessionId="";pluginClients=new Map;mcpInstances=new Map;totalCommandsProcessed=0;historyManager=null;constructor(e){this.config=e,this.app=(0,ux.default)(),this.baseUrl=`http://${e.httpHost}:${e.httpPort}`,this.sessionId=this.generateSessionId(),this.setupMiddleware(),this.setupRoutes()}generateSessionId(){let e=this.instanceId.replace(/-/g,"").substring(0,8).toUpperCase();return`${e.substring(0,4)}-${e.substring(4,8)}`}getSessionId(){return this.sessionId}setupMiddleware(){this.app.use(ux.default.json()),this.app.use((e,r,n)=>{r.setHeader("Access-Control-Allow-Origin","http://localhost:3002"),r.setHeader("Access-Control-Allow-Methods","GET, POST, OPTIONS"),r.setHeader("Access-Control-Allow-Headers","Content-Type"),n()}),this.app.use((e,r,n)=>{if(!this.checkRateLimit(e.ip||"unknown")){r.status(429).json({error:"Rate limit exceeded",limit:this.config.maxRequestsPerMinute});return}n()}),this.app.use((e,r,n)=>{S.debug(`${e.method} ${e.path}`,{ip:e.ip}),n()})}checkRateLimit(e){let r=Date.now(),n=r-6e4,i=this.requestCounts.get(e)||[];return i=i.filter(a=>a>n),i.length>=this.config.maxRequestsPerMinute?!1:(i.push(r),this.requestCounts.set(e,i),!0)}setupRoutes(){this.app.get("/events",(e,r)=>this.handleSSEConnection(e,r)),this.app.get("/commands",(e,r)=>this.handleCommandsPoll(e,r)),this.app.post("/result",(e,r)=>this.handleResult(e,r)),this.app.post("/selection-update",(e,r)=>this.handleSelectionUpdate(e,r)),this.app.post("/execute",(e,r)=>this.handleExecute(e,r)),this.app.get("/cached-selection",(e,r)=>this.handleCachedSelectionRequest(e,r)),this.app.post("/register-plugin",(e,r)=>this.handleRegisterPlugin(e,r)),this.app.post("/unregister-plugin",(e,r)=>this.handleUnregisterPlugin(e,r)),this.app.post("/register-mcp",(e,r)=>this.handleRegisterMCP(e,r)),this.app.post("/unregister-mcp",(e,r)=>this.handleUnregisterMCP(e,r)),this.app.get("/connection-info",(e,r)=>this.handleConnectionInfo(r)),this.app.post("/logs",(e,r)=>this.handleLogs(e,r)),this.app.post("/quota-status",(e,r)=>this.handleQuotaStatus(e,r)),this.app.get("/status",(e,r)=>this.handleStatus(r)),this.app.post("/shutdown",(e,r)=>this.handleShutdown(e,r)),this.app.options("*",(e,r)=>{r.sendStatus(200)})}setHistoryManager(e){this.historyManager=e}handleSSEConnection(e,r){S.info("Plugin connected via SSE"),r.setHeader("Content-Type","text/event-stream"),r.setHeader("Cache-Control","no-cache"),r.setHeader("Connection","keep-alive"),this.sseClients.add(r),this.sendSSEEvent(r,{event:"command",id:Rr(),data:{action:"connected",requestId:Rr(),params:{serverVersion:At,timestamp:Date.now()}}});let n=setInterval(()=>{this.sendSSEEvent(r,{event:"command",id:Rr(),data:{action:"keepalive",requestId:Rr(),params:{timestamp:Date.now()}}})},3e4);r.on("close",()=>{S.info("Plugin disconnected from SSE"),clearInterval(n),this.sseClients.delete(r)})}sendSSEEvent(e,r){let n=JSON.stringify(r.data);e.write(`event: ${r.event}
|
|
149
149
|
`),e.write(`id: ${r.id}
|
|
150
150
|
`),e.write(`data: ${n}
|
|
151
151
|
|