BoardGameGeek MCP 서버

이는 BoardGameGeek XML API와 통합되는 MCP(Model Context Protocol) 서버로, 클로드가 보드 게임을 검색하고, 게임 세부 정보를 가져오고, 사용자 컬렉션을 가져오는 등의 작업을 수행할 수 있게 해줍니다.

특징

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

검색-게임 : 이름으로 보드 게임 검색
get-game-details : 특정 보드 게임에 대한 자세한 정보를 얻습니다.
get-hot-games : BoardGameGeek에서 현재 가장 인기 있는 보드 게임을 만나보세요
get-user-collection : 필터링 옵션을 사용하여 사용자의 보드 게임 컬렉션을 가져옵니다.
sync-user-collection : BoardGameGeek에서 사용자 컬렉션을 동기화합니다.
get-user-plays : 사용자의 최근 보드 게임 플레이 내역을 가져옵니다.
sync-user-plays : BoardGameGeek에서 사용자의 플레이를 동기화합니다.
get-similar-games : 지정된 게임과 유사한 게임 가져오기

기능 체크리스트

[x] 검색
[x] 게임 세부 정보 가져오기
[x] 인기 게임
[ ] 사용자 플레이 가져오기
[ ] 사용자 재생 동기화
[ ] 사용자 컬렉션 가져오기
[ ] 사용자 컬렉션 동기화
[ ] 비슷한 게임 받기

필수 조건

Node.js 22.5.0 이상(실험적 SQLite 지원에 필요)
npm(종속성 관리용)

건물과 운영

서버를 빌드하려면:

지엑스피1

서버를 직접 실행하려면:

# The --experimental-sqlite flag is required
node --experimental-sqlite build/index.js

Docker로 실행하려면:

# Build the Docker image
docker build -t bgg-mcp-server .

# Run the container
docker run --rm -i bgg-mcp-server

테스트

서버가 올바르게 작동하는지 확인하려면:

# Make sure the server is built first
npm run build

# Run the test script with the experimental SQLite flag
node --experimental-sqlite test-mcp.js

테스트 스크립트는 다음과 같습니다.

MCP 서버를 시작합니다
검색 게임 기능을 테스트하세요
get-hot-games 기능을 테스트해보세요
결과 및 오류 표시

Claude와 함께 데스크톱 사용

Claude for Desktop 구성 파일을 엽니다.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Node.js를 직접 실행하기 위한 서버 구성을 추가합니다.

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "node",
      "args": ["--experimental-sqlite", "/path/to/bgg-mcp-server/build/index.js"]
    }
  }
}

또는 Docker를 사용하세요(권장):

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "bash",
      "args": ["-c", "cd /path/to/bgg-mcp-server && docker build -t bgg-mcp-server . && docker run --rm -i -v \"$(pwd)/data:/app/data\" bgg-mcp-server"]
    }
  }
}

참고: -v "$(pwd)/data:/app/data" 옵션은 로컬 data 디렉토리를 Docker 컨테이너의 /app/data 디렉토리에 마운트하여 SQLite 데이터베이스가 컨테이너 외부에 유지되도록 합니다.

데스크톱용 Claude 재시작

예시 질문

Claude에 연결되면 다음과 같은 질문을 할 수 있습니다.

"보드게임긱에 새로 나온 인기 게임은 뭐예요?"
"보드게임긱에서 몰리하우스 게임을 검색해 보세요"

데이터 저장

서버는 데이터 보존을 위해 SQLite를 사용합니다. 검색된 모든 게임 데이터, 사용자 컬렉션, 플레이 기록은 data/bgg.sqlite 데이터베이스 파일에 저장됩니다. 이는 다음과 같습니다.

BoardGameGeek에 대한 API 호출을 줄입니다.
반복되는 쿼리에 대한 응답 시간을 개선합니다.
서버 재시작 사이에 데이터를 유지합니다.

데이터베이스가 존재하지 않으면 자동으로 생성되고, 서버를 사용하면 데이터베이스가 자동으로 채워집니다.

BoardGameGeek MCP Server

Integrations