MCP 服务器

XenozMCP

An MCP server that bridges AI to Roblox Studio, enabling execution of Luau scripts, instance manipulation, play-testing control, and Open Cloud operations via natural language.

README

⟦ XENOZMCP ⟧ AI neural bridge for the Roblox metaverse

╔═══════════════════════════════════════════════════════╗
║  XENOZMCP  —  v0.1.0                                 ║
║  AI → Roblox Studio neural bridge                    ║
║  Transport: stdio | WebSocket :17613                  ║
║  Encryption: AES-256-GCM                             ║
║  Status: ████████████ 100% operational               ║
╚═══════════════════════════════════════════════════════╝

XenozMCP is a Model Context Protocol server that opens a neural link between AI consciousness and the Roblox metaverse. It translates AI intent into Studio actions — executing Luau, manipulating instances, controlling play-testing, and commanding the Open Cloud — all secured by military-grade AES-256-GCM encryption.

Connect any MCP-compatible client (Claude, Cursor, Copilot) or inject directly into 8 AI chat sites via the browser extension. One protocol. Infinite creation.

SYSTEM ARCHITECTURE

┌─────────────────────────────────────────────────────┐
│                    AI CONSCIOUSNESS                  │
│         Claude · Cursor · GPT · DeepSeek            │
└─────────────────────┬───────────────────────────────┘
                      │ stdio / WebSocket
                      ▼
┌─────────────────────────────────────────────────────┐
│                  XENOZMCP KERNEL                     │
│                                                     │
│  ┌────────────┐  ┌────────────┐  ┌───────────────┐  │
│  │Studio MCP  │  │Open Cloud  │  │AES-256-GCM    │  │
│  │Controller  │  │Gateway     │  │Encrypted Vault│  │
│  └─────┬──────┘  └──────┬─────┘  └───────┬───────┘  │
│        │                │                │          │
│  ┌─────┴──────┐  ┌──────┴─────┐          │          │
│  │StudioMCP   │  │apis.roblox │          │          │
│  │.exe (stdio)│  │.com (REST) │          │          │
│  └─────┬──────┘  └────────────┘          │          │
│        │                                  │          │
└────────┼──────────────────────────────────┼──────────┘
         │                                  │
         ▼                                  ▼
  ┌──────────────┐                 ┌──────────────────┐
  │ Roblox Studio│                 │  Local Vault     │
  │  Metaverse   │                 │  (encrypted keys)│
  └──────────────┘                 └──────────────────┘

Dual-Channel Communication

Channel	Transport	Port	Clients
MCP Core	stdio	—	Claude Desktop, Cursor, Claude Code, Copilot
Extension Bridge	WebSocket	`17613`	DeepSeek, ChatGPT, Claude, Gemini, Qwen, Mistral, Perplexity

DEPLOYMENT

Prerequisites

Node.js ≥ 18 — the runtime
Roblox Studio — with MCP enabled (Assistant → MCP Servers → Studio as MCP Server)

Quick Launch

# Clone from the source
git clone https://github.com/Xenoz-GitHub/XenozMCP.git
cd XenozMCP

# Initialize the kernel
npm install
npm run build

# Activate the bridge
node dist/index.js

Or double-click start-xenoz.bat on Windows — it auto-installs, builds, and fires up.

Extension Injection (for AI chat sites)

chrome://extensions → Developer Mode → Load unpacked → select extension/

Then open any supported AI site and hit ▶ Start Studio Agent.

Claude Desktop Configuration

{
  "mcpServers": {
    "xenoz-mcp": {
      "command": "node",
      "args": ["path/to/XenozMCP/dist/index.js"]
    }
  }
}

COMMAND MATRIX

System Core

Command	Function	Security
`studio_status`	Ping the neural link	—
`vault_set`	Encrypt & store a secret	AES-256-GCM
`vault_get`	Decrypt & retrieve	AES-256-GCM
`vault_has`	Probe key existence	—
`vault_list`	Enumerate stored keys	—

Studio Manipulation

Command	Function
`list_studio_commands`	Scan available Studio MCP commands
`execute_luau`	Inject and run Luau bytecode
`script_read`	Extract script source by path
`screen_capture`	Photograph the viewport (multi-angle)
`inspect_instance`	Read instance properties and children
`start_stop_play`	Toggle play-testing dimension
`get_studio_state`	Query the Studio status matrix
`search_game_tree`	Locate instances by name or class
`open_place`	Open a place by ID

Open Cloud Commands

Command	Function
`cloud_list_data_stores`	Scan data store index
`cloud_get_data_store_entry`	Read from the data stream
`cloud_set_data_store_entry`	Write to the data stream
`cloud_get_universe_info`	Access universe metadata
`cloud_publish_place`	Deploy a place to production
`cloud_list_places`	Map all places in a universe
`cloud_send_notification`	Broadcast to all active players

SECURITY PROTOCOL

XenozMCP uses AES-256-GCM (Galois/Counter Mode) for all secret storage — the same encryption standard securing banking and military communications. Each secret is encrypted with a unique initialization vector, authenticated with a 128-bit GCM tag, and derived through 600,000 PBKDF2 iterations.

plaintext → AES-256-GCM → iv:tag:ciphertext → vault.store

Set your vault key via XENOZ_VAULT_KEY environment variable, or let XenozMCP generate one on first launch.

CONFIGURATION

Edit config.json to bind your Open Cloud credentials:

{
  "openCloud": {
    "apiKey": "your-api-key",
    "defaultUniverseId": "123456789"
  }
}

Sensitive values can also be injected at runtime through the vault_set command — never stored in plaintext.

ENVIRONMENT VARIABLES

Variable	Purpose
`XENOZ_VAULT_KEY`	64-char hex key for the AES-256-GCM vault

LICENSE

MIT — fork it, mod it, deploy it.

built by XenozExe ⟦ 0x7F >_ 0x3A ⟧