Roblex Studio MCP Server

🚀 羅布樂克斯工作室模型上下文協議服務器

羅布樂克斯工作室MCP服務器是一個獨立實現模型上下文協議規範的服務器，專為與羅布樂克斯工作室和大語言模型（LLMs）集成而設計。它能讓Roblox Studio通過統一協議，輕鬆實現無縫、安全且可腳本化的AI驅動工作流程。

🚀 快速開始

先決條件

• Node.js 18或更高版本（建議使用Node.js 20+）
• 已安裝羅布樂克斯工作室（僅限Windows；如需配置路徑，請參見下方說明）
• npm（隨Node.js捆綁提供）

使用npx運行

npx roblex-mcp

• 第一次啟動時，MCP會自動啟動並嘗試打開羅布樂克斯工作室。
• 如果您的羅布樂克斯工作室不在標準位置，請在.env文件或系統環境變量中設置ROBLOX_STUDIO_PATH。

環境配置

複製並編輯示例環境文件：

cp .env.example .env

根據需要編輯.env文件（請參見下方關於ROBLOX_STUDIO_PATH的說明）。

羅布樂克斯開放雲API密鑰設置

為了啟用自動化腳本和資產管理，必須提供有效的羅布樂克斯開放雲API密鑰。

1. 訪問羅布樂克斯開放雲控制檯。
2. 按照指示創建並獲取API密鑰。

將生成的密鑰添加到您的.env文件中，例如：

ROBLOX_API_KEY=your_api_key_here

克隆項目

git clone https://github.com/dmae97/roblex-studio-mcp-server.git
cd roblex-studio-mcp-server

安裝依賴

npm install

構建項目

npm run build

啟動服務

npm start

環境變量配置

創建或編輯.env文件，並添加以下內容：

ROBLOX_API_KEY=your_api_key_here
ROBLOX_STUDIO_PATH=path_to_robx_studio

將path_to_robx_studio替換為羅布樂克斯工作室的實際安裝路徑。

✨ 主要特性

• npx一行安裝/運行：使用npx roblex-mcp命令即可快速啟動。
• 自動打開羅布樂克斯工作室：MCP啟動後會自動打開羅布樂克斯工作室（僅限Windows）。
• 完整的MCP實現：全面支持模型上下文協議的核心功能。
• 多種傳輸模式：支持SSE或STDIO，提供靈活的集成方式。
• Claude Desktop/Anthropic Claude支持：開箱即用的集成。
• 安全性：TPA保護、輸入sanitization（淨化）、速率限制、CORS等安全措施。
• 可擴展性：輕鬆添加自定義工具和資源。

📚 詳細文檔

項目簡介

羅布樂克斯工作室MCP服務器是一個獨立實現模型上下文協議的服務器，旨在為羅布樂克斯工作室提供AI驅動的功能支持。

功能特性

• npx一行安裝/運行：通過簡單的命令即可啟動服務。
• 自動打開羅布樂克斯工作室：在Windows系統上，MCP會自動啟動羅布樂克斯工作室。
• 完整的協議支持：全面實現模型上下文協議的核心功能。
• 多種傳輸模式：支持SSE流式通信和標準輸入輸出（STDIO）。
• Claude Desktop集成：無縫對接Claude Desktop和Anthropic的Claude大語言模型。
• 安全性增強：內置TPA保護機制，確保輸入淨化、速率限制和CORS策略等安全措施。

項目貢獻

歡迎各位開發者參與項目的開發與維護！請參考CONTRIBUTING.md瞭解具體貢獻指南。

📄 許可證

本項目採用MIT許可證，具體內容詳見LICENSE文件。