lotto

This MCP server automates interactions with the Tonghap Lottery site to buy Lotto tickets and check results. It exposes two main tools: purchase_lotto, which logs into the user’s Tonghap Lottery account and automatically purchases a specified number of Lotto games (up to 5 per request), and check_lotto_winning, which checks the results for given Lotto numbers (and an optional round). The server stores credentials securely (either in a base64-encoded simple mode or via AES-encrypted configuration when you enable the advanced flow). You can run the server through the recommended npx setup, or use Docker for effortless deployment. For Claude Desktop users, configure the mcpServers block with the appropriate command and environment variable, then issue natural-language requests like “로또 3게임 구매해줘” or “이 로또 번호들 당첨 확인해줘: [[1,2,3,4,5,6]]” to trigger the actions.

Prerequisites:

• Node.js 18.0.0 or newer (for local installation)
• npm (comes with Node.js)
• Optional: Docker if you prefer running via container

방법 1: npx 사용 (권장)

• 설치가 필요 없이 바로 실행 가능:
  • npx @labforadvanced.study/lotto-mcp-server --setup
  • 또는 계정 정보를 base64로 인코딩하여 환경 변수로 전달

방법 2: Docker 사용

• Docker 이미지를 사용해 배포 가능:
  • docker run --rm -i -e LOTTO_CREDENTIALS=base64_credentials your-dockerhub-username/lotto-mcp-server:latest

방법 3: 로컬 설치 (소스에서 빌드)

• 필수 조건:
  • Node.js 18+ 설치
• 설치 단계:

  npm install
  npm run install-playwright
  npm run build
  

• 계정 정보 설정(두 가지 방법 중 하나):
  • 간단 모드(Base64):

    npm run simple-encode
    

  • 고급 모드(AES):

    npm run encrypt-credentials
    

• 실행:

  npm start
  

참고: Docker 방법은 별도의 설치 없이 즉시 실행 가능하며, npx 방법은 가장 간편하고 빠르게 테스트할 수 있습니다.

환경 변수 및 설정 옵션:

• LOTTO_CREDENTIALS: base64로 인코딩된 'id,password' 문자열(간단 모드) 또는 AES 암호화된 값을 사용합니다.
• 로또 구매 시 최대 5게임까지 한 번에 구매 가능하며, Playwright를 사용해 브라우저를 자동으로 제어합니다.
• 브라우저 리소스 관리: headless 모드와 기본 화면 크기를 src/lotto-service.ts에서 설정할 수 있습니다.
• 문제 해결: Playwright 브라우저 설치 문제는 npx playwright install chromium으로 재설치합니다.
• 보안 모드 선택에 따라 암호화 방식이 다르므로 환경에 맞춰 설정하십시오.

참고 경로:

• 로컬 빌드의 경우 dist/index.js 경로를 사용하도록 구성할 수 있습니다.