Skip to main content
Glama
README.md
# ScriptBlox MCP

Pont Cursor ↔ [ScriptBlox](https://scriptblox.com/) : recherche, lecture, upload/edit/delete via **extension Chrome** + serveur MCP local.

Repo : https://github.com/ErrorNoName/scriptblox-mcp

Hubs associés : https://github.com/ErrorNoName/Xeno-Hubs

## Architecture

```
Cursor ──stdio──► scriptblox-mcp (FastMCP)
                      │
                      ├── HTTP 127.0.0.1:8767  (auth + jobs Turnstile)
                      │
Chrome extension ◄────┘
   └── content script sur scriptblox.com
         • popup « MCP Connections » (consent scopes)
         • jobs upload + captcha Cloudflare Turnstile
```

## Installation

```bat
Install.bat
```

### Extension Chrome / Edge

1. `chrome://extensions` → Mode développeur
2. **Charger l'extension non empaquetée** → dossier `extension\`
3. Login sur https://scriptblox.com/

### Cursor `mcp.json`

```json
{
  "mcpServers": {
    "scriptblox": {
      "command": "C:\\path\\to\\scriptblox-mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\scriptblox-mcp\\run_mcp.py"],
      "env": {
        "SCRIPTBLOX_MCP_HOST": "127.0.0.1",
        "SCRIPTBLOX_MCP_PORT": "8767"
      }
    }
  }
}
```

## Connexion

1. `scriptblox_connect` dans Cursor
2. Popup **MCP Connections** → Autoriser
3. `scriptblox_me` pour vérifier

Token local : `%USERPROFILE%\.scriptblox-mcp\credentials.json` (jamais commit)

## Tests

```bat
.venv\Scripts\python.exe -m pytest tests -q
```

## Licence

Usage personnel / éducatif. Respecte les ToS ScriptBlox et Roblox.