RbxBridge

RbxBridge is a monorepo for a future bridge between AI tooling and Roblox Studio workflows.

The current repository state is still intentionally focused: it contains the apps/mcp-server bootstrap with transport-separated MCP runtime and an application-level pairing/session layer for HTTP validation.

Monorepo topology (conceptual)

• apps/mcp-server: Nest.js runtime that hosts MCP tools. Current stage supports:
  • stdio transport
  • Streamable HTTP transport (transport-level stateless)
  • application-level pairing/session orchestration (server-side in-memory)
• apps/roblox-plugin (future): Planned Roblox Studio-side integration. Not scaffolded or implemented in this task.
• packages/shared-contracts (future, when needed): Planned place for shared schemas/contracts once both server and plugin need real code sharing.
• docs: Architecture notes, decision records, and task records.

What is implemented now

• Shared MCP runtime assembly that registers one toolset for multiple transports.
• stdio bootstrap path for local process-based inspector/client checks.
• Streamable HTTP bootstrap path for MCP calls (/mcp) with no built-in ChatGPT UI auth.
• Application-level pairing/session flow for HTTP bootstrap checks:
  • POST /pairing/start
  • POST /pairing/restore
  • one-time pairing code (short-lived)
  • restore key plus split session binding:
    • ChatGPT flow: resolved from x-openai-session
    • token-based flow: resolved from pairedSessionToken
• Current MCP tools:
  • system.ping
  • system.info
  • test.signature
  • session.status
  • session.pairConfirm
  • session.disconnect
  • plugin.echo (requires active paired session)

What is not implemented in this stage

• OAuth or other built-in HTTP auth integration.
• Production security posture for HTTP exposure.
• Roblox Studio plugin implementation and plugin-side persistence.
• WebSocket bridge / dynamic capability model / generic plugin RPC.
• Persistent storage/database-backed session state.
• Shared runtime contracts package as working code.

More details

• MCP server app guide: apps/mcp-server/README.md
• MVP architecture note: docs/mcp-server-mvp.md
• Latest decision note for pairing/session bootstrap: docs/decisions/mcp-http-pairing-session-bootstrap.md