MCP LaunchBox

AI 어시스턴트가 사용자의 LaunchBox 게임 라이브러리를 조회할 수 있게 해주는 MCP 서버입니다. AI 어시스턴트에서 직접 모든 플랫폼(Steam, GOG, Epic, 에뮬레이터 등)에 걸쳐 전체 게임 컬렉션을 검색하세요.

Claude Desktop, Claude Code 또는 모든 MCP 호환 클라이언트에서 작동합니다.

사용 사례

• 게임 번들 스크린샷을 보내 이미 소유하고 있는 게임인지 확인 (퍼지 매칭이 OCR 오류 및 오타를 처리)

• 게임 할인 구매 전 빠른 조회

• 플랫폼 또는 이름별로 라이브러리 탐색

• 게임 플레이 시간 확인

• 아직 플레이하지 않은 설치된 게임 찾기

• 플랫폼 전반에 걸쳐 현재 플레이 중인 게임 확인

Related MCP server: gamelibs-mcp

설정

Node.js 20+ 버전이 필요합니다.

1. LaunchBox 설치

게임 데이터가 포함된 LaunchBox가 설치되어 있어야 합니다.

2. MCP 클라이언트 구성

MCP 클라이언트 구성에 서버를 추가합니다. 두 가지 방법이 있습니다:

옵션 A: GitHub에서 직접 실행 (설치 불필요)

{
  "mcpServers": {
    "launchbox": {
      "command": "npx",
      "args": ["-y", "github:danjam/mcp-launchbox"],
      "env": {
        "LAUNCHBOX_PLATFORMS_PATH": "C:/LaunchBox/Data/Platforms"
      }
    }
  }
}

옵션 B: 로컬로 복제 및 실행

git clone https://github.com/danjam/mcp-launchbox.git
cd mcp-launchbox
npm install

그런 다음 MCP 클라이언트를 로컬 빌드 경로로 지정합니다:

{
  "mcpServers": {
    "launchbox": {
      "command": "node",
      "args": ["/path/to/mcp-launchbox/dist/index.js"],
      "env": {
        "LAUNCHBOX_PLATFORMS_PATH": "C:/LaunchBox/Data/Platforms"
      }
    }
  }
}

/path/to/mcp-launchbox를 프로젝트를 복제한 실제 경로로 바꾸십시오.

기능

게임 검색

제목으로 게임 라이브러리를 검색합니다. 제목 및 시리즈 필드 전반에 걸쳐 퍼지 매칭을 사용합니다. 기본적으로 매칭 전에 구두점(대시, 콜론, &/and)이 정규화됩니다.

신뢰도 척도: 1.0 = 완벽 일치, ≥0.85 = 매우 높음, ≥0.65 = 가능성 있음, <0.65 = 추측성. 전체 메타데이터는 get_game_details를 사용하세요.

도구: search_games

라이브러리 확인

목록에 있는 게임 중 이미 라이브러리에 있는 게임을 확인합니다. 먼저 정확한 제목 일치를 사용한 다음 퍼지 매칭을 사용합니다. 오탐지를 방지하기 위해 신뢰도가 ≥0.85인 경우에만 포함됩니다. 일치하는 항목이 없으면 nearMisses에 진단을 위한 최대 5개의 근접 후보가 표시됩니다. 기본적으로 매칭 전에 구두점이 정규화됩니다.

번들 중복 확인을 위해 설계되었습니다. 한 번에 하나씩 검색하는 대신 한 번의 호출로 모든 제목을 전달하세요. (번들 확인을 위해) 플랫폼을 생략하면 모든 플랫폼에서 확인합니다.

도구: check_library

게임 상세 정보 가져오기

ID를 통해 특정 게임의 전체 상세 정보를 가져옵니다. camelCase로 모든 메타데이터를 반환합니다: 제목, 플랫폼, 개발자, 장르(배열), 시리즈, 평점(communityStarRating 및 starRating, 둘 다 0–5), 플레이 시간({seconds, hours}), 설치 상태 등. 문자열 필드가 비어 있거나 누락된 경우 null이 반환됩니다.

도구: get_game_details

플랫폼 목록

라이브러리에 있는 모든 플랫폼과 게임 수를 나열합니다. 매개변수가 필요하지 않습니다.

도구: list_platforms

중복 찾기

제목별로 그룹화된 중복 게임 항목을 찾습니다. 플랫폼 간 및 동일 플랫폼 내 중복 항목을 모두 포함합니다.

도구: find_duplicates

통계 가져오기

라이브러리 요약 통계(총 게임 수, 총 플랫폼 수, 게임 수 기준 상위 10개 플랫폼)를 가져옵니다. 매개변수가 필요하지 않습니다.

도구: get_stats

라이브러리 새로고침

디스크에서 모든 게임 데이터를 다시 로드합니다. LaunchBox에서 게임을 추가하거나 제거한 후 사용하세요. 매개변수가 필요하지 않습니다.

도구: reload_library

라이선스

MIT