roblox-studio-physical-operation-mcp

# Roblox Studio MCP 一个用于控制 Roblox Studio 的 MCP (Model Context Protocol) 服务。 ## 安装 ```bash pip install roblox-studio-physical-operation-mcp ``` ## 配置 MCP ### Claude Desktop 编辑 `%APPDATA%\Claude\claude_desktop_config.json`： ```json { "mcpServers": { "roblox-studio": { "command": "python", "args": ["-m", "roblox_studio_physical_operation_mcp"] } } } ``` ### Droid 编辑 `~/.factory/mcp.json`： ```json { "mcpServers": { "roblox-studio": { "type": "stdio", "command": "python", "args": ["-m", "roblox_studio_physical_operation_mcp"] } } } ``` > **注意**：Windows Store 版 Python 可能需要使用完整路径： > ```json > "command": "C:\\Users\\<用户名>\\AppData\\Local\\Microsoft\\WindowsApps\\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\\python.exe" > ``` ## 从源码安装 ```bash git clone https://github.com/white-dragon-tools/roblox-studio-physical-operation-mcp.git cd roblox-studio-physical-operation-mcp pip install -r requirements.txt python -m roblox_studio_physical_operation_mcp ``` --- ## AI 使用指南 ### ⚠️ 重要：获取 place_path 或 place_id **不知道 place_path 或 place_id 时，必须先调用 `studio_list()` 获取！** ```python # 先获取当前运行的 Studio 实例 instances = studio_list() # 返回示例: # [{"pid": 12345, "type": "local", "place_path": "D:/game.rbxl"}, # {"pid": 67890, "type": "cloud", "place_id": 110155533210141}] # 然后用返回的 place_path 或 place_id 操作 logs_get(place_path=instances[0]["place_path"]) ``` ### 推荐工作流程 **调试已打开的 Studio** ``` 1. studio_list() # 获取运行中的 Studio 实例 2. studio_query(place_path) # 查询状态 3. modal_close(place_path) # 如果有模态弹窗，关闭它们 4. game_start(place_path) # 开始游戏 5. logs_get(place_path) # 获取日志 6. game_stop(place_path) # 停止游戏 ``` **打开新的 Studio** ``` 1. studio_open(place_path) # 打开 Studio（本地文件） 2. studio_query(place_path) # 查询状态 3. modal_close(place_path) # 如果有模态弹窗，关闭它们 4. studio_query(place_path) # 确认 ready=true 5. game_start(place_path) # 开始游戏 6. logs_get(place_path) # 获取日志 7. game_st…