MCP GameBoy Server

MCP 게임보이 서버

개요

서버보이용 모델 컨텍스트 프로토콜(MCP) 서버로, LLM이 게임보이 에뮬레이터와 상호 작용할 수 있도록 지원합니다. LLM은...

• ROM 로드
• 키를 누르세요
• 게임보이 화면을 보세요
• 프레임 건너뛰기

당신은 할 수 있습니다...

• @modelcontextprotocol/inspector를 사용하여 게임보이 에뮬레이터를 제어합니다.
• http://localhost:3001/emulator 에서 웹 인터페이스를 사용하여 게임보이 에뮬레이터를 제어하고 ROM을 업로드합니다.
• 좋아하는 MCP-Client에 게임보이 에뮬레이터를 설치하세요

특징

• stdio와 SSE 전송을 모두 지원합니다
• GameBoy 컨트롤(위, 아래, 왼쪽, 오른쪽, A, B, 시작, 선택)을 위한 도구를 제공합니다.
• 다양한 ROM을 로드하기 위한 도구를 제공합니다.
• 현재 화면을 얻기 위한 도구를 제공합니다
• 모든 도구는 최신 화면 프레임이 포함된 ImageContent를 반환합니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 GameBoy Emulator Server를 자동으로 설치하려면:

지엑스피1

FLUJO 에 설치하기

1. 서버 추가를 클릭하세요
2. Github URL을 복사하여 FLUJO에 붙여넣기
3. 분석, 복제, 설치, 빌드 및 저장을 클릭합니다.

수동 설치

구성 파일을 통한 설치

주의 : 많은 MCP 클라이언트는 .env 변수에 ROM 경로를 절대 경로 로 지정해야 합니다.

구성 파일을 통해 이 MCP 서버를 Cline이나 다른 MCP 클라이언트와 통합하려면:

1. Cline 설정을 엽니다.
   • VS Code에서 파일 -> 환경 설정 -> 설정으로 이동합니다.
   • "Cline MCP 설정"을 검색하세요
   • "settings.json에서 편집"을 클릭하세요.
2. mcpServers 개체에 서버 구성을 추가합니다.
   { "mcpServers": { "mcp-gameboy": { "command": "node", "args": [ "/path/to/mcp-gameboy/dist/index.js" ], "disabled": false, "autoApprove": [] } } }
3. /path/to/mcp-gameboy/dist/index.js 프로젝트 디렉터리에 있는 index.js 파일의 실제 경로로 바꾸세요. Windows에서는 경로에 슬래시(/) 또는 이중 백슬래시(\\)를 사용하세요.
4. 설정 파일을 저장하세요. Cline이 자동으로 서버에 연결될 것입니다.

용법

환경 변수

주의 : 많은 MCP 클라이언트는 .env 변수에 ROM 경로를 절대 경로 로 지정해야 합니다.

다음 변수를 사용하여 루트 디렉토리에 .env 파일을 만듭니다.

stdio 모드에서 실행

stdio 모드에서 서버는 ROM_PATH 환경 변수에 지정된 ROM 경로를 사용합니다. 브라우저 창을 열어 GameBoy 화면을 표시합니다.

SSE 모드에서 실행

SSE 모드에서는 서버는 ROM 선택을 위한 웹 페이지를 제공하는 Express 서버를 시작합니다.

그런 다음 브라우저를 열어 http://localhost:3001 로 접속하여 ROM을 선택하세요.

도구

서버는 다음과 같은 도구를 제공합니다.

• press_up : 게임보이의 UP 버튼을 누르세요
• press_down : 게임보이의 DOWN 버튼을 누르세요
• press_left : 게임보이의 왼쪽 버튼을 누르세요
• press_right : 게임보이의 오른쪽 버튼을 누르세요
• press_a : 게임보이의 A 버튼을 누르세요
• press_b : 게임보이의 B 버튼을 누르세요
• press_start : 게임보이의 START 버튼을 누르세요
• press_select : GameBoy의 SELECT 버튼을 누르세요
• load_rom : GameBoy ROM 파일을 로드합니다
• get_screen : 현재 GameBoy 화면을 가져옵니다

모든 도구는 최신 화면 프레임이 포함된 ImageContent를 반환합니다.

구현 세부 사항

이 서버는 MCP(Model Context Protocol) TypeScript SDK를 사용하여 구축되었습니다. 다음을 사용합니다.

• 서버 구현을 위한 @modelcontextprotocol/sdk/server/mcp.js 의 McpServer
• stdio 전송을 위한 @modelcontextprotocol/sdk/server/stdio.js 의 StdioServerTransport
• SSE 전송을 위한 @modelcontextprotocol/sdk/server/sse.js 의 SSEServerTransport
• GameBoy 에뮬레이션을 위한 serverboy
• SSE 모드에서 웹 서버를 위한 express
• GameBoy 화면 렌더링을 위한 canvas

특허

MIT