{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_gmfgumusce9m","handle":"roblox-studio-physical-operation-mcp","url":"https://wellknown.network/agents/roblox-studio-physical-operation-mcp","links":{"self":"https://wellknown.network/agents/roblox-studio-physical-operation-mcp/record.json","html":"https://wellknown.network/agents/roblox-studio-physical-operation-mcp","markdown":"https://wellknown.network/agents/roblox-studio-physical-operation-mcp/record.md","api":"https://wellknown.network/api/v1/agents/roblox-studio-physical-operation-mcp","status":"https://wellknown.network/api/v1/agents/roblox-studio-physical-operation-mcp/status","claim":"https://wellknown.network/agents/roblox-studio-physical-operation-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/roblox-studio-physical-operation-mcp/claim.json","badge":"https://wellknown.network/agents/roblox-studio-physical-operation-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/roblox-studio-physical-operation-mcp/history","tools":"https://wellknown.network/api/v1/agents/roblox-studio-physical-operation-mcp/tools"},"ard":{"identifier":"urn:air::server:roblox-studio-physical-operation-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"roblox-studio-physical-operation-mcp","summary":"MCP server for controlling Roblox Studio - toolbar detection, game control, log analysis","description":"# Roblox Studio MCP\n\n一个用于控制 Roblox Studio 的 MCP (Model Context Protocol) 服务。\n\n## 安装\n\n```bash\npip install roblox-studio-physical-operation-mcp\n```\n\n## 配置 MCP\n\n### Claude Desktop\n\n编辑 `%APPDATA%\\Claude\\claude_desktop_config.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"roblox-studio\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"roblox_studio_physical_operation_mcp\"]\n    }\n  }\n}\n```\n\n### Droid\n\n编辑 `~/.factory/mcp.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"roblox-studio\": {\n      \"type\": \"stdio\",\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"roblox_studio_physical_operation_mcp\"]\n    }\n  }\n}\n```\n\n> **注意**：Windows Store 版 Python 可能需要使用完整路径：\n> ```json\n> \"command\": \"C:\\\\Users\\\\<用户名>\\\\AppData\\\\Local\\\\Microsoft\\\\WindowsApps\\\\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\\\\python.exe\"\n> ```\n\n## 从源码安装\n\n```bash\ngit clone https://github.com/white-dragon-tools/roblox-studio-physical-operation-mcp.git\ncd roblox-studio-physical-operation-mcp\npip install -r requirements.txt\npython -m roblox_studio_physical_operation_mcp\n```\n\n---\n\n## AI 使用指南\n\n### ⚠️ 重要：获取 place_path 或 place_id\n\n**不知道 place_path 或 place_id 时，必须先调用 `studio_list()` 获取！**\n\n```python\n# 先获取当前运行的 Studio 实例\ninstances = studio_list()\n# 返回示例:\n# [{\"pid\": 12345, \"type\": \"local\", \"place_path\": \"D:/game.rbxl\"},\n#  {\"pid\": 67890, \"type\": \"cloud\", \"place_id\": 110155533210141}]\n\n# 然后用返回的 place_path 或 place_id 操作\nlogs_get(place_path=instances[0][\"place_path\"])\n```\n\n### 推荐工作流程\n\n**调试已打开的 Studio**\n```\n1. studio_list()               # 获取运行中的 Studio 实例\n2. studio_query(place_path)    # 查询状态\n3. modal_close(place_path)     # 如果有模态弹窗，关闭它们\n4. game_start(place_path)      # 开始游戏\n5. logs_get(place_path)        # 获取日志\n6. game_stop(place_path)       # 停止游戏\n```\n\n**打开新的 Studio**\n```\n1. studio_open(place_path)     # 打开 Studio（本地文件）\n2. studio_query(place_path)    # 查询状态\n3. modal_close(place_path)     # 如果有模态弹窗，关闭它们\n4. studio_query(place_path)    # 确认 ready=true\n5. game_start(place_path)      # 开始游戏\n6. logs_get(place_path)        # 获取日志\n7. game_st…","publisher":{"name":"White Dragon Tools","url":null},"homepage":"https://github.com/white-dragon-tools/roblox-studio-physical-operation-mcp","repository":"https://github.com/white-dragon-tools/roblox-studio-physical-operation-mcp","version":"0.2.1","license":null,"protocols":["mcp"],"tags":["automation","mcp","model-context-protocol","roblox","roblox-studio"],"pricing":null,"endpoints":[{"url":"pypi:roblox-studio-physical-operation-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"roblox-studio-physical-operation-mcp","registry":"pypi","observedAt":"2026-11-03T23:23:04.075Z","publishedAt":"2026-02-06T05:34:55.235181Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"roblox-studio-physical-operation-mcp","url":"https://pypi.org/project/roblox-studio-physical-operation-mcp/","firstSeenAt":"2026-09-10T11:27:14.210Z","fetchedAt":"2026-11-03T23:22:23.237Z","normalizedAt":"2026-11-03T23:22:23.237Z"}]},"firstSeenAt":"2026-09-10T11:27:14.210Z","updatedAt":"2026-11-03T23:23:04.075Z"}