GB Studio MCP Server — MCP-сервер для Claude Code
MCP-сервер, через который агент собирает и правит проекты GB Studio: сцены, актёров, ассеты и проверку логики. Пригодится, если делаете игру под Game Boy по текстовому описанию.
claude mcp add gbstudio-claude-mcp -e CLAUDE_API_KEY=<CLAUDE_API_KEY> -- npx -y gbstudio-claude-mcpЧто делает GB Studio MCP Server
Сервер написан на TypeScript и работает с проектами GB Studio по протоколу MCP. Через него агент находит проект, проверяет его и создаёт игровые ассеты: сцены, актёров, графику. Есть и отдельный режим проверки — прогон смоук-тестов, чтобы поймать ошибки в логике до сборки ROM.
Запускается двумя частями. Основной REST-сервер слушает http://localhost:3000, а MCP-режим по stdio проксирует запросы к нему, поэтому сначала поднимают REST-часть. Порт меняется переменными GBSTUDIO_API_URL или GBSTUDIO_API_PORT. Для работы нужен ключ CLAUDE_API_KEY — его передают при подключении сервера к клиенту.
Ставится глобально через npm: npm install -g gbstudio-claude-mcp, запуск — командой gbstudio-claude-mcp. Без ключа в конфигурации клиента сервер не заработает, это первое, что стоит проверить. Тот же сервер заявлен совместимым с GBA Studio — форком GB Studio под GBA.
Какие задачи решает
- собрать шаблон игры под Game Boy из текстового описания
- сгенерировать сцены и актёров для нового проекта
- накидать стартовые ассеты и графику в GB Studio
- прогнать смоук-тесты логики проекта до сборки ROM
- проверить и расширить готовый учебный шаблон игры
Примеры запросов агенту
- Сгенерируй шаблон вертикального скролл-шутера под оригинальный Game Boy: корабль, враги, бонусы.
- Проверь логику сцен в моём проекте GB Studio и покажи, где ломается переход между сценами.
- Собери простой клон Pong для Game Boy: две платформы, мяч, счёт.
Как установить GB Studio MCP Server
Командой платформы
claude mcp add gbstudio-claude-mcp -e CLAUDE_API_KEY=<CLAUDE_API_KEY> -- npx -y gbstudio-claude-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add gb-studio-mcp-server --env CLAUDE_API_KEY=<CLAUDE_API_KEY> -- npx -y gbstudio-claude-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"gb-studio-mcp-server": {
"command": "npx",
"args": [
"-y",
"gbstudio-claude-mcp"
],
"env": {
"CLAUDE_API_KEY": "<CLAUDE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"gb-studio-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gbstudio-claude-mcp"
],
"env": {
"CLAUDE_API_KEY": "<CLAUDE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CLAUDE_API_KEY=<CLAUDE_API_KEY> gb-studio-mcp-server npx -y gbstudio-claude-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о GB Studio MCP Server
Как установить GB Studio MCP Server в Claude Code?
Сначала поставьте пакет: npm install -g gbstudio-claude-mcp. Затем добавьте сервер: claude mcp add gbstudio-claude-mcp -e CLAUDE_API_KEY=<CLAUDE_API_KEY> -- npx -y gbstudio-claude-mcp.
Что делает GB Studio MCP Server?
Даёт агенту инструменты для работы с проектами GB Studio: поиск проекта, валидация, создание сцен, актёров и ассетов, а также смоук-тесты логики.
Что нужно, чтобы сервер заработал?
Ключ CLAUDE_API_KEY в конфигурации клиента и запущенный REST-сервер на http://localhost:3000 — MCP-режим по stdio проксирует запросы к нему.
