/ 目錄 / 演練場 / robloxstudio-mcp
● 社群 boshyxd ⚡ 即開即用

robloxstudio-mcp

作者 boshyxd · boshyxd/robloxstudio-mcp

AI-powered Roblox Studio workflows — explore game structure, read/edit scripts, bulk modify, and playtest via MCP.

robloxstudio-mcp connects AI assistants to Roblox Studio for agentic game development. Two editions: Full (43 tools) for complete read/write control and Inspector (21 read-only tools) for safe exploration. Tools cover game tree inspection, script management, object search, property modification, attribute/tag management, and playtest control. Built with TypeScript, available via npm.

為什麼要用

核心特性

即時演示

實際使用效果

robloxstudio-mcp-2.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "robloxstudio-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/boshyxd/robloxstudio-mcp"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "robloxstudio-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/boshyxd/robloxstudio-mcp"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "robloxstudio-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/boshyxd/robloxstudio-mcp"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "robloxstudio-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/boshyxd/robloxstudio-mcp"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "robloxstudio-mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/boshyxd/robloxstudio-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "robloxstudio-mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/boshyxd/robloxstudio-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add robloxstudio-mcp-2 -- TODO 'See README: https://github.com/boshyxd/robloxstudio-mcp'

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: robloxstudio-mcp

How to explore and understand a Roblox game with AI

👤 Roblox developers onboarding onto an existing game project ⏱ ~15 min beginner

何時使用: You inherited a Roblox project and need to understand its structure.

前置條件
  • Roblox Studio with plugin installed — Copy plugin to Plugins folder, enable HTTP Requests in Experience Settings
  • MCP client configured — Set up Claude Desktop or Codex with the server
步驟
  1. Get overview
    Show me the game's file tree and project structure. What are the main systems?✓ 已複製
    → Hierarchical view of game services and major scripts
  2. Search for patterns
    Grep all scripts for references to 'DataStore' or 'RemoteEvent'. Which scripts handle player data?✓ 已複製
    → List of scripts with matched lines and file paths

結果: A clear understanding of the game's architecture and key systems.

注意事項
  • Large games have thousands of instances — Use search_objects and grep_scripts to focus on specific areas instead of browsing the full tree

Write and test Roblox scripts with AI assistance

👤 Roblox developers who want AI help writing Lua scripts ⏱ ~30 min intermediate

何時使用: You need to create or modify game scripts and want AI-assisted development.

前置條件
  • Full edition MCP connected — Use the full version for write access
步驟
  1. Read existing code
    Read the script in ServerScriptService/GameManager. Explain what it does and suggest improvements.✓ 已複製
    → Code with analysis and improvement suggestions
  2. Write new functionality
    Add a leaderboard system that tracks kills and deaths. Create the scripts and UI elements needed.✓ 已複製
    → New scripts and UI created in the game
  3. Playtest
    Start a playtest and check the output for any errors related to our new leaderboard system.✓ 已複製
    → Playtest output with error analysis

結果: New game functionality written, deployed, and tested with AI assistance.

注意事項
  • HTTP Requests not enabled — Go to Experience Settings → Security → Enable 'Allow HTTP Requests'. Required for the plugin to communicate.

組合

與其他 MCP 搭配,撬動十倍槓桿

robloxstudio-mcp-2 + filesystem

Export game scripts to local files for version control

Export all scripts in ServerScriptService to ~/roblox-project/server/ for Git tracking.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
get_file_tree none Get the game's instance hierarchy 0
get_script_source instance_path: str Read a script's source code 0
grep_scripts pattern: str Search across all scripts for a pattern 0
search_objects class_name?: str, name?: str Find objects by class or name 0
start_playtest none Start a playtest in Roblox Studio 0
get_playtest_output none Read the output/error log from a playtest 0

成本與限制

運行它的成本

API 配額
N/A — local communication with Roblox Studio
每次呼叫 Token 數
100–1000 tokens per tool call
費用
Free — Roblox Studio is free
提示
Use grep_scripts to find relevant code instead of reading every script.

安全

權限、密鑰、影響範圍

憑證儲存: N/A
資料出站: Communication between MCP server and local Roblox Studio plugin via HTTP localhost

故障排查

常見錯誤與修復

Plugin shows 'Disconnected'

Ensure the MCP server is running and the Studio plugin can reach localhost. Enable 'Allow HTTP Requests' in Experience Settings.

驗證: Check the Output panel in Studio for connection messages
Script edit not saving

The Full edition is required for write operations. Inspector edition is read-only.

驗證: Check which edition you installed
Playtest won't start

Close any existing playtest session first. Only one playtest can run at a time.

驗證: Check Studio for an active playtest

替代方案

robloxstudio-mcp 對比其他方案

替代方案何時用它替代權衡
Minecraft MCP ServerYou want AI-controlled gameplay in Minecraft rather than Roblox developmentDifferent platform — Minecraft is gameplay, Roblox Studio is game development
Godot MCP ProYou prefer Godot for game development over RobloxDifferent engine — Godot is open source, Roblox is a platform

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills