Обзор

Сервер Model Context Protocol (MCP) для serverboy, позволяющий LLM взаимодействовать с эмулятором GameBoy. Ваш LLM может…

• Загрузка ROMS
• Нажмите клавиши Посмотрите на экран Gameboy
• пропустить кадры

Вы можете…

• управлять эмулятором геймбоя с помощью @modelcontextprotocol/inspector
• управлять эмулятором геймбоя (и загружать ПЗУ) с помощью веб-интерфейса на http://localhost:3001/emulator Установите эмулятор геймбоя в любимом MCP-Client

Особенности

• Поддерживает как стио, так и транспорт SSE Предоставляет инструменты для управления GameBoy (вверх, вниз, влево, вправо, A, B, старт, выбор)
• Предоставляет инструменты для загрузки различных ПЗУ Предоставляет инструменты для получения текущего экрана Все инструменты возвращают ImageContent с последней рамкой экрана

##Установка

###Установка через Smithery

Для автоматической установки GameBoy Emulator Server для Claude Desktop через Smithery:

###Установка в FLUJO 1.Нажмите Добавить сервер 2.Копировать и вставлять Github URL в FLUJO 3. Нажмите Парс, Клон, Установить, Строить и Сохранить.

Ручная установка

###Установка через файлы конфигурации

! ** ВНИМАНИЕ**: Многие клиенты MCP требуют указать ROM-Path в .env vars как абсолютный путь

MCP GameBoy Server

Overview

A Model Context Protocol (MCP) server for serverboy, allowing LLMs to interact with a GameBoy emulator. Your LLM can…

• Load ROMS
• Press Keys
• Look at the Gameboy Screen
• skip frames

You can…

• control the gameboy emulator using the @modelcontextprotocol/inspector
• control the gameboy emulator (and upload ROMs) using a web-interface at http://localhost:3001/emulator
• install the gameboy emulator in your favorite MCP-Client

Features

• Supports both stdio and SSE transports
• Provides tools for GameBoy controls (up, down, left, right, A, B, start, select)
• Provides tools to load different ROMs
• Provides tools to get the current screen
• All tools return an ImageContent with the latest screen frame

Installation

Installing via Smithery

To install GameBoy Emulator Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mario-andreschak/mcp-gameboy --client claude

Installing in FLUJO

1. Click Add Server
2. Copy & Paste Github URL into FLUJO
3. Click Parse, Clone, Install, Build and Save.

Manual Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-gameboy.git
cd mcp-gameboy

# Install dependencies
npm install

# Build the project
npm run build

Installing via Configuration Files

!! ATTENTION : Many MCP Clients require to specify the ROM-Path in the .env vars as an absolute path

To integrate this MCP server with Cline or other MCP clients via configuration files:

1. Open your Cline settings:

   • In VS Code, go to File -> Preferences -> Settings
   • Search for “Cline MCP Settings”
   • Click “Edit in settings.json”

2. Add the server configuration to the mcpServers object:

   {
     "mcpServers": {
       "mcp-gameboy": {
         "command": "node",
         "args": [
           "/path/to/mcp-gameboy/dist/index.js"
         ],
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. Replace /path/to/mcp-gameboy/dist/index.js with the actual path to the index.js file in your project directory. Use forward slashes (/) or double backslashes (\\) for the path on Windows.