项目简介

Vibe Blocks MCP 是一个基于 Model Context Protocol (MCP) 的服务器实现，它作为桥梁连接 Roblox Studio 和支持 MCP 协议的AI编码编辑器（如 Cursor, Windsurf）。通过提供对 Roblox Studio 环境的访问能力，它使得AI能够理解并与您的实时游戏开发会话进行交互。

主要功能点

• 实时Studio交互： 允许AI直接在 Roblox Studio 中操作场景对象（创建、删除、移动、设置属性等）、检查对象结构、创建/编辑/执行 Luau 脚本、设置环境属性（如光照、地形）、控制NPC动画等。
• Roblox Cloud API集成（可选）： 如果配置了API Key，可以执行云端 Luau 脚本（不在Studio中运行）、管理 DataStore 数据、上传本地资产（模型、图片、音频）以及发布游戏版本。
• Studio日志获取： 可以获取 Roblox Studio 输出窗口的最新日志信息。

安装步骤

1. 准备环境： 确保安装了 Python 3.10+、'uv' 包管理器（或 'pip'）和 Roblox Studio。如果需要使用 Cloud 功能，请准备好 Roblox API Key、Universe ID 和 Place ID。
2. 克隆仓库： 使用 git clone 命令下载项目代码。
3. 安装依赖： 进入项目目录，使用 'uv' (推荐) 或 'pip' 安装 Python 依赖。
4. 配置Cloud功能（可选）： 复制 '.env.example' 为 '.env' 文件，编辑并填入您的 Roblox API Key、Universe ID 和 Place ID。
5. 安装Studio插件： 安装 Rojo 工具（如果需要从源代码构建插件），然后构建或直接使用仓库中提供的插件文件 ('.rbxm')，将其放入 Roblox Studio 的插件文件夹中。重启 Studio 使插件加载。
6. 运行服务器： 在项目根目录的终端中运行 './server.sh' 脚本来启动 Python 服务器。服务器通常运行在 'http://localhost:8000'。保持终端开启。

MCP客户端配置

要在您的 MCP 客户端（如 Cursor）中连接此服务器，您需要进行如下配置：

• 服务器名称： 您可以自定义一个名称，例如 "Vibe Blocks MCP"。
• 连接URL (SSE)： 服务器的 SSE 端点是 'http://localhost:8000/sse'。请将此 URL 填写到客户端的连接设置中。

重要提示： 您需要先按照上述“安装步骤”手动运行服务器脚本（'./server.sh'），然后再在 MCP 客户端中添加和连接此服务器。本仓库的说明未提供通过客户端命令启动服务器的配置方式。

基本使用方法

确保服务器正在运行，Studio 插件已安装并加载，且您的 MCP 客户端已成功连接。然后，您可以在 AI 聊天界面中通过调用服务器提供的工具来与 Studio 或 Roblox Cloud 进行交互。

例如，您可以尝试向AI发送类似以下的指令：

• "Create a red Part named 'Cube' in Workspace."
• "List the children of ServerScriptService."
• "Execute this script in Studio: print('Hello from Studio!')"
• "Get the value for key 'high_score' from the 'PlayerData' datastore in the cloud."

请参考 AI 客户端的具体工具调用语法（例如 @-mention 工具名称）。