로또 MCP 서버

동행복권에서 로또를 자동으로 구매하고 당첨 결과를 확인할 수 있는 MCP(Model Context Protocol) 서버입니다.

📋 기능

• 로또 자동 구매: 동행복권 계정으로 로그인하여 로또를 자동으로 구매
• 당첨 결과 확인: 구매한 로또 번호의 당첨 결과를 자동으로 확인
• 보안 강화: ID/패스워드를 암호화하여 안전하게 저장
• Docker 지원: 별도 설치 없이 Docker로 바로 실행 가능

🚀 설치 및 실행 방법

방법 1: npx 사용 (추천) ⚡

# 계정 설정 도우미
npx @labforadvanced.study/lotto-mcp-server --setup

# 또는 직접 인코딩
echo "your_id,your_password" | base64

Claude Desktop 설정:

{
  "mcpServers": {
    "lotto": {
      "command": "npx",
      "args": ["@labforadvanced.study/lotto-mcp-server"],
      "env": {
        "LOTTO_CREDENTIALS": "your_base64_credentials"
      }
    }
  }
}

자세한 npm 사용법은 NPM_GUIDE.md를 참고하세요.

방법 2: Docker 사용 🐳

별도 설치나 빌드 없이 배포된 Docker 이미지를 바로 사용할 수 있습니다!

1단계: 계정 정보 인코딩

터미널에서 간단하게 인코딩:

# macOS/Linux
echo "your_lotto_id,your_password" | base64

# Windows (PowerShell)
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("your_id,your_password"))

# 결과 예시: bXlfbG90dG9faWQsbXlfcGFzc3dvcmQ=

2단계: Claude Desktop 설정

claude_desktop_config.json 파일에 다음 설정을 추가:

{
  "mcpServers": {
    "lotto": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LOTTO_CREDENTIALS=bXlfbG90dG9faWQsbXlfcGFzc3dvcmQ=",
        "your-dockerhub-username/lotto-mcp-server:latest"
      ]
    }
  }
}

3단계: Claude Desktop 재시작

Claude Desktop을 재시작하면 바로 사용 가능합니다!

로또 3게임 구매해줘

방법 3: 로컬 설치

2-1. 필수 조건

• Node.js 18.0.0 이상
• 동행복권 계정 (미리 예치금 충전 필요)

2-2. 설치

# 의존성 설치
npm install

# Playwright 브라우저 설치
npm run install-playwright

# 빌드
npm run build

3. 계정 정보 설정 (두 가지 방법)

방법 1: 간단 모드 (Base64 인코딩) - 추천 ⭐

# 방법 1-A: 인터랙티브 도구 사용
npm run encrypt-credentials
# 선택: 1 (간단 모드)

# 방법 1-B: 간단 스크립트 사용
npm run simple-encode

# 방법 1-C: 터미널에서 직접
echo "your_id,your_password" | base64

출력 예시:

{
  "mcpServers": {
    "lotto": {
      "command": "node",
      "args": ["path/to/lotto-mcp-server/dist/index.js"],
      "env": {
        "LOTTO_CREDENTIALS": "eW91cl9pZCx5b3VyX3Bhc3N3b3Jk"
      }
    }
  }
}

방법 2: 고급 모드 (AES 암호화)

npm run encrypt-credentials
# 선택: 2 (고급 모드)

출력 예시:

{
  "mcpServers": {
    "lotto": {
      "command": "node",
      "args": ["path/to/lotto-mcp-server/dist/index.js"],
      "env": {
        "LOTTO_ENCRYPTED_ID": "YWJjZGVmZ2hpams...",
        "LOTTO_ENCRYPTED_PASSWORD": "bXlwYXNzd29yZA...",
        "LOTTO_SECRET_KEY": "optional-custom-key"
      }
    }
  }
}

4. Claude Desktop 설정

1. 위에서 생성된 설정을 claude_desktop_config.json 파일에 복사
2. "path/to/lotto-mcp-server/dist/index.js"를 실제 경로로 변경
3. Claude Desktop 재시작

5. 개발 모드 실행

npm run dev

6. 프로덕션 실행

npm start

🛠️ 사용법

이 MCP 서버는 다음 두 가지 도구를 제공합니다:

1. purchase_lotto - 로또 구매

동행복권에서 로또를 자동으로 구매합니다. ID/패스워드는 설정에서 자동으로 가져옵니다.

입력 파라미터:

• count (number): 구매할 로또 게임 수 (1-5)

출력 예시:

{
  "success": true,
  "numbers": [
    [1, 14, 21, 27, 30, 44],
    [4, 5, 27, 29, 40, 44],
    [9, 18, 19, 24, 38, 42]
  ],
  "message": "3게임을 성공적으로 구매했습니다."
}

2. check_lotto_winning - 당첨 확인

로또 번호의 당첨 결과를 확인합니다.

입력 파라미터:

• numbers (array): 확인할 로또 번호 배열 (예: [[1,2,3,4,5,6], [7,8,9,10,11,12]])
• round (number, 선택사항): 확인할 회차 (기본값: 현재 회차)

출력 예시:

{
  "success": true,
  "results": [
    {
      "numbers": [1, 2, 3, 4, 5, 6],
      "rank": 5,
      "matchedNumbers": [1, 2, 3]
    },
    {
      "numbers": [7, 8, 9, 10, 11, 12],
      "rank": 0,
      "matchedNumbers": []
    }
  ],
  "message": "1143회차 당첨 결과를 확인했습니다."
}

💡 MCP 클라이언트에서 사용하기

Claude Desktop에서 사용

설정 완료 후 Claude에서 다음과 같이 사용:

로또 3게임 구매해줘

이 로또 번호들 당첨 확인해줘: [[1,2,3,4,5,6], [7,8,9,10,11,12]]

🔐 보안 기능

간단 모드 (Base64) - 추천

• 터미널에서 echo "id,password" | base64로 간단 생성
• raw 패스워드가 그대로 노출되지 않음
• 설정 파일에서 패스워드 직접 확인 불가
• 대부분 사용자에게 충분한 보안 수준

고급 모드 (AES 암호화)

• AES-256-CBC 대칭 암호화
• 사용자 정의 암호화 키 지원
• Base64 추가 인코딩으로 보안층 강화
• 고급 보안이 필요한 경우 사용

터미널에서 직접 생성하기

간단 모드를 터미널에서 직접 생성할 수 있습니다:

# macOS/Linux
echo "your_id,your_password" | base64

# Windows (PowerShell)
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("your_id,your_password"))

보안 수준 비교

| 방식 | 보안 수준 | 편의성 | 사용 상황 | |------|-----------|--------|-----------| | 간단 모드 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 일반 사용자, 개인 PC | | 고급 모드 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | 민감한 환경, 공용 PC |

⚠️ 주의사항

1. 예치금 충전: 구매 전에 동행복권 계정에 충분한 예치금을 미리 충전해두어야 합니다.
2. 계정 보안: 암호화된 계정 정보와 시크릿 키를 안전하게 관리하세요.
3. 구매 한도: 한 번에 최대 5게임까지만 구매 가능합니다.
4. 당첨 번호: 로또 번호는 1~45 사이의 숫자 6개여야 합니다.
5. 브라우저 자원: Playwright가 Chromium을 실행하므로 시스템 리소스를 사용합니다.

🔧 설정 옵션

src/lotto-service.ts 파일에서 다음 옵션을 수정할 수 있습니다:

this.lottoService = new BaseLottoService({
  controller: chromium,
  headless: true,              // false로 변경하면 브라우저 창이 보임
  defaultViewport: { 
    width: 1280, 
    height: 720 
  },
  logLevel: 2                  // 로그 레벨 (0: ERROR, 1: WARN, 2: INFO, 3: DEBUG)
});

📁 프로젝트 구조

lotto-mcp-server/
├── src/
│   ├── index.ts              # MCP 서버 메인 파일
│   ├── lotto-service.ts      # 로또 서비스 클래스
│   ├── crypto-utils.ts       # 암호화/복호화 유틸리티
│   └── encrypt-credentials.ts # 계정 정보 인코딩 도구
├── scripts/
│   └── simple-encode.sh      # 간단 인코딩 스크립트
├── dist/                     # 빌드 결과물
├── package.json
├── tsconfig.json
└── README.md

🐛 문제 해결

브라우저 설치 오류

# Playwright 브라우저 재설치
npx playwright install chromium

계정 정보 오류

# 간단 모드로 재설정
npm run simple-encode

# 또는 고급 모드로 재설정
npm run encrypt-credentials

로그인 실패

• ID와 패스워드가 정확한지 확인
• 동행복권 사이트에 직접 로그인해서 계정 상태 확인
• 보안 설정으로 인한 로그인 제한 여부 확인

구매 실패

• 계정에 충분한 예치금이 있는지 확인
• 동행복권 사이트의 서비스 시간 확인 (토요일 밤~일요일 오후는 서비스 중단)

📄 라이선스

MIT License

🤝 기여

버그 리포트나 기능 제안은 이슈로 등록해주세요.

⚖️ 법적 고지

이 도구는 동행복권의 공식 API를 사용하지 않고 웹 스크래핑을 통해 작동합니다. 사용에 따른 모든 책임은 사용자에게 있으며, 과도한 사용으로 인한 계정 제재나 기타 문제에 대해서는 책임지지 않습니다.