/ Annuaire / Playground / robloxstudio-mcp
● Communauté boshyxd ⚡ Instantané

robloxstudio-mcp

par 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.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

robloxstudio-mcp-2.replay ▶ prêt
0/0

Installer

Choisissez votre client

~/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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : robloxstudio-mcp

How to explore and understand a Roblox game with AI

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

Quand l'utiliser : You inherited a Roblox project and need to understand its structure.

Prérequis
  • 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
Déroulement
  1. Get overview
    Show me the game's file tree and project structure. What are the main systems?✓ Copié
    → 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?✓ Copié
    → List of scripts with matched lines and file paths

Résultat : A clear understanding of the game's architecture and key systems.

Pièges
  • 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

Quand l'utiliser : You need to create or modify game scripts and want AI-assisted development.

Prérequis
  • Full edition MCP connected — Use the full version for write access
Déroulement
  1. Read existing code
    Read the script in ServerScriptService/GameManager. Explain what it does and suggest improvements.✓ Copié
    → 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.✓ Copié
    → 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.✓ Copié
    → Playtest output with error analysis

Résultat : New game functionality written, deployed, and tested with AI assistance.

Pièges
  • HTTP Requests not enabled — Go to Experience Settings → Security → Enable 'Allow HTTP Requests'. Required for the plugin to communicate.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

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.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
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

Coût et limites

Coût d'exécution

Quota d'API
N/A — local communication with Roblox Studio
Tokens par appel
100–1000 tokens per tool call
Monétaire
Free — Roblox Studio is free
Astuce
Use grep_scripts to find relevant code instead of reading every script.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : N/A
Sortie de données : Communication between MCP server and local Roblox Studio plugin via HTTP localhost

Dépannage

Erreurs courantes et correctifs

Plugin shows 'Disconnected'

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

Vérifier : 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.

Vérifier : Check which edition you installed
Playtest won't start

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

Vérifier : Check Studio for an active playtest

Alternatives

robloxstudio-mcp vs autres

AlternativeQuand l'utiliserCompromis
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

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills