# Roblox MCP — AI God Mode Dashboard

**Version:** 1.0  
**Author:** Zsombi & Hermes Agent (Nous Research)  
**Status:** Working prototype

---

## Description

**Roblox MCP** (Model Context Protocol) is an AI-driven dashboard for Roblox games. The system operates as an MCP server, enabling AI assistants (Gemini/OpenAI) to communicate with Roblox games in real time. The project includes a Starlette/uvicorn web application with a modern "God Mode" themed frontend.

---

## File Structure

```
Roblox MCP/
│
├── roblox_ai_client.py         # Main AI client and server (293 lines)
├── requirements.txt            # Python dependencies
│
├── static/                     # Static files
│   ├── index.html              # Dashboard HTML (God Mode theme)
│   ├── style.css               # Stylesheet
│   └── script.js               # JavaScript client
│
└── README.md                   # This document
```

---

## Usage

### Installation

```bash
pip install -r requirements.txt
```

### Starting the Server

```bash
python roblox_ai_client.py
```

The server starts at `http://localhost:8000` by default.

### Accessing the Dashboard

Open in your browser:
```
http://localhost:8000
```

---

## Features

- **AI Chat** — Real-time chat with Gemini/OpenAI models
- **MCP Connection** — Model Context Protocol integration
- **WebSocket** — Real-time bidirectional communication
- **Log System** — Real-time log forwarding to frontend
- **Multiple AI Providers** — Gemini and OpenAI support
- **Chat History** — Session-based chat history
- **God Mode Dashboard** — Cyberpunk/sci-fi themed interface

---

## API Endpoints

| Endpoint | Type | Description |
|---------|-------|--------|
| `/` | GET | Dashboard HTML |
| `/api/connect-mcp` | POST | Create MCP connection |
| `/api/chat` | POST | Send chat message |
| `/ws/{client_id}` | WebSocket | Real-time connection |
| `/static/` | Mount | Static files |

---

## Dependencies

- **Python** 3.10+
- **mcp** ≥ 1.0.0 — Model Context Protocol
- **openai** ≥ 1.12.0 — OpenAI API client
- **python-dotenv** ≥ 1.0.0 — Environment variables
- **fastapi** ≥ 0.100.0 — Web framework (Starlette)
- **uvicorn** ≥ 0.22.0 — ASGI server
- **websockets** ≥ 11.0.0 — WebSocket support

---

## Environment Variables

Create a `.env` file:

```env
# Gemini API
GOOGLE_API_KEY=your_key_here

# OpenAI API (optional)
OPENAI_API_KEY=your_key_here
```

---

## Developer

Zsombi & Hermes Agent (Nous Research)