scratch-mcp
Allows reading, editing, and saving Scratch .sb3 project files programmatically, with tools for modifying sprites, scripts, costumes, sounds, and other project assets.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
scratch4js
A pnpm monorepo of small, focused JavaScript packages for working with Scratch
and TurboWarp β edit .sb3 projects programmatically, talk to the Scratch
website, drive it all from an AI agent, and build & bundle TurboWarp extensions.
π Documentation: https://playforge-coding.github.io/scratch4js/
Packages
Path | Package | What it is |
| The core library: read/edit | |
| A class-based wrapper for the Scratch website API: read public data, and log in to download/edit/publish | |
| An MCP server exposing the library's editing surface as tools, plus a TurboWarp live-reload bridge. | |
| webpack/Rspack plugin that bundles a multi-file TurboWarp extension into one IIFE-wrapped file. | |
| Rollup/Rolldown/Vite plugin that bundles a multi-file TurboWarp extension into one IIFE-wrapped file. | |
| Scaffolder ( | |
| Reusable React building blocks for in-browser IDEs: split-pane layout, Monaco, an xterm/WebContainer terminal, file tree. | |
| In-browser IDE (built on | |
| TurboWarp Desktop userscript (ES modules β one IIFE): scratch-mcp live-reload + real-time collaboration over a WebSocket relay. |
Related MCP server: scratch-mcp
How they fit together
AI agent / MCP client
β (MCP tools over stdio)
βΌ
ββββββββββββββββ edits in memory ββββββββββββββ
β scratch-mcp β βββββββββββββββββββΊ β scratch4js β
ββββββββ¬ββββββββ save β .sb3 file ββββββββββββββ
β WebSocket bridge (localhost:9060)
βΌ "loadSB3" β fetch /get.sb3
TurboWarp Desktop + userscript βββΊ live previewAn agent edits a project through scratch-mcp; on save the server writes the
.sb3 and signals the userscript, which reloads it into TurboWarp Desktop
instantly.
Getting started
pnpm install
pnpm build # build every package (-r build)
pnpm lint
pnpm fmt # prettier --write .Then:
Install the userscript into TurboWarp Desktop (
pnpm --filter userscript deploy; per-OS paths in its README).Run the MCP server and point your MCP client at it.
Open
.sb3files, edit, andsave_projectto see changes live.
Workspace layout
.
βββ packages/
β βββ scratch4js/ # the core library (+ examples + example.sb3)
β βββ s-api4js/ # Scratch website API wrapper
β βββ scratch-mcp/ # the MCP server + live-reload bridge
β βββ tw-plugin-webpack/ # webpack/Rspack extension bundler plugin
β βββ tw-plugin-rollup/ # Rollup/Rolldown/Vite extension bundler plugin
β βββ create-tw-extension/ # extension scaffolder CLI
β βββ web-editor/ # in-browser IDE building blocks
β βββ tw-extension-maker/ # in-browser extension IDE
β βββ userscript/ # TurboWarp Desktop userscript: live-reload + collaboration
βββ docs/ # Rspress documentation site
βββ pnpm-workspace.yaml
βββ package.json # workspace root (build/lint/fmt delegate to -r)Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Nifty's MCP server β exposes tasks, projects, messages, and files as tools for AI agents.
Project management shared by people and AI agents, with persistent project state through MCP.
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
FlicenseNot gradedqualityDmaintenanceEnables AI agents to extract, sync, test, and debug Roblox games bidirectionally between Studio and filesystem via MCP.37-- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, compile, and run Scratch projects by editing plain text and using a live editor loop.30 npm1Mozilla Public 2.0
- AlicenseBqualityCmaintenanceEnables editing Scratch .sb3 projects programmatically, including sprites, blocks, costumes, sounds, variables, and online project sharing, plus headless VM execution and live-reload in TurboWarp Desktop.4330 npmMozilla Public 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to drive a running Roblox Studio in real time over a single WebSocket, executing whole Luau programs, installing in-engine controllers, hot-patching scripts during live playtests, and receiving errors, assertions and other events as pushes. It also reaches Roblox Open Cloud for the open place and answers visual questions via a vision sidecar, exposing all of this through nine MCP tools.91MIT