/ 目录 / 演练场 / 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