GB Studio MCP Server
Create and modify GB Studio projects with MCP tools for scenes, actors, assets, and validation.
★ 3NOASSERTIONother
Install
Config snippet generator goes here (5 client tabs)
README
## GB Studio Agentic MCP Server for creating GameBoy Games. Prompt to build out a template for your students, kids, or yourself to extend. <img width="1228" height="695" alt="image" src="https://github.com/user-attachments/assets/3c909c0d-bd1c-44cd-b80d-a83bd5c15e9c" />   ## Quick Start 1. **Install**: `npm install -g gbstudio-claude-mcp` 2. **Start server**: `gbstudio-claude-mcp` 3. **Connect Claude Desktop** (see TUTORIAL.md) 4. **Prompt Claude**: "Review and test my application logic" That’s it. Claude will reivew, extend or even generate a playable game template you can iterate on with students in GB Studio. ## Vibe Coding, LLMs, and Modern Education: Can give students Constructive Tools, Not Just Answers After 14 years teaching kids programming, electronics, 3D printing, and game development, I’ve learned this: the best educational tools don’t just make things easier. They make learning a rewarding activity. GB Studio is one of those tools. It’s a visual game builder that gives you a Game Boy development, putting real creative power in the hands of students, educators, and hobbyists to build for physical hardware. When we combine GB Studio with education on what is possible to do with large language models (LLMs), we bring a postitive view to students on how they can integrate with rather than rely on them as a crutch. ## What is Vibe Coding? “Vibe coding” isn’t just a buzzword. It’s a paradigm shift. It’s programming stripped of syntactic gatekeeping, where creators focus on flow, logic, and ideas instead of memorizing semicolons. Tools like Scratch, App Inventor, and GB Studio embody this philosophy: they eliminate barriers and recenter programming around what actually matters: creativity and problem-solving. For kids, vibe coding is a what they are growing up with. It will let them focus on the “why” and “how” of programming without drowning in syntax. This isn’t just helpful. It’s important for students to get to think in systems, design, and logic but are shut out by traditional coding’s steep learning curve. ## The Role of LLMs in Education Large language models like ChatGPT have sparked fierce debate in education, and for good reason. Used carelessly, they become cheating tools that replaces thinking with copy-pasa mindset. But used with purpos, they can become scaffolding that accelerates real learning. The difference isn’t the tool. It’s how we wield it. ## This is exactly why I built the Clawdbot MCP server. By integrating LLMs directly with GB Studio, users and teachers can: * Scaffold projects: Generate starter templates, assets, and event flows from simple prompts. * Automate testing: Run smoke tests to catch bugs and validate project logic. * Encourage iteration: Help students refine their projects by providing suggestions and examples. Games can be built from scratch too but they wont be AAA class so measure your expectations lol ### Pong (Game Boy) ``` Create a Pong clone for the original Game Boy. Two paddles, a ball, and a score counter. The player controls the left paddle, the right paddle is AI-controlled. Use simple monochrome graphics and authentic GB sound effects. Generate all scenes, actors, and assets for a playable Pong game. ``` ### Pac-Man (Game Boy Color) ``` Build a Pac-Man style maze game for Game Boy Color. The player navigates a maze, collects pellets, and avoids ghosts. Include at least one maze layout, four ghosts with basic AI, and colorful graphics. Generate all scenes, actors, and assets needed for a playable demo. ``` ### Mario Bros Style Platformer (Game Boy Color) ``` Design a Mario Bros inspired platformer for Game Boy Color. The player can run, jump, and stomp on enemies. Include three levels, power-ups, coins, and a flagpole at the end of each level. Use bright palettes and catchy background music. Generate all scenes, actors, and assets for a classic platformer experience. ``` ### Space Shooter (Game Boy) ``` Create a vertical scrolling space shooter for the original Game Boy. The player controls a spaceship, shoots enemies, and dodges obstacles. Include multiple enemy types, power-ups, and a boss fight. Use classic GB graphics and chiptune sound effects. Generate all scenes, actors, and assets for a playable shooter. ``` # Claude MCP Server for GB Studio This is a TypeScript server for manipulating GB Studio projects using the Model Context Protocol (MCP). It provides endpoints for project discovery, validation, and creation of game assets. --- ## Installation Install globally with npm: ```sh npm install -g gbstudio-claude-mcp ``` --- ## Local Environment Setup (.env) For local development, store API keys and configuration in a `.env` file at the project root. This keeps secrets out of source control and matches the pattern used in GitHub Ac