rajephon/k-lottery

동행복권 로또 6/45 구매·잔액·당첨 확인 CLI + MCP 서버.

About k-lottery

동행복권 로또 6/45를 대신 사고, 잔액도 보고, 당첨됐는지도 확인해주는 도구예요. 터미널에서 명령어로 써도 되고, Claude Code나 Claude Desktop에서 말로 시켜도 돼요. CLI 4개랑 MCP 서버가 같은 코어를 써요.

직접 쓰려고 만든 개인용 도구예요. 진짜 돈이 나가니까 쓰기 전에 면책을 꼭 읽어주세요.

- 무엇을 할 수 있나 - 요구사항 - 빠른 시작 - MCP 서버 설정 - 안전장치 - CLI 사용법 - 환경변수 - 종료 코드 - 자동화 예시 (cron) - 알아둘 점 - 개발 - 기여 · 면책 · 라이선스

CLI 하는 일 --- --- scripts/balance.py 예치금·구매 한도·서약 유효성 scripts/check.py 구매 내역과 당첨 결과 (등수는 서버가 계산) scripts/deposit.py 충전용 가상계좌 발급 (이체는 직접) scripts/buy.py 자동번호 구매 (기본 dry-run)

MCP 도구 파라미터 노출 하는 일 --- --- --- --- lottostatus — 항상 잔액·한도·서약 유효성·가상계좌(뒤 4자리만) lottoresults days=14, roundno? 항상 구매 내역 + 당첨 결과 lottodraw roundno 항상 공개 추첨 결과 (로그인 불필요) lottobuyprecheck games=5 항상 구매 전 점검만. 절대 사지 않음 lottobuy games=5 게이트 실제 구매 (승인 필수) lottodeposit amount 게이트 가상계좌 발급 (승인 필수)

--- --- uv 필수예요. Python 3.13은 uv가 .python-version을 보고 알아서 받아와요 동행복권 계정 아이디/비밀번호로 로그인하는 계정이요 건전구매 서약 사이트에서 직접 하셔야 해요. 만료됐으면 구매가 막혀요 (종료코드 3) 예치금 충전하려면 은행 이체가 필요해서 완전 무인화는 안 돼요 OS macOS에서 확인했어요. Linux도 될 것 같고, Windows는 안 해봤어요

CLI와 같은 코어 위에 FastMCP(stdio) 서버를 올려뒀어요. 잔액이나 당첨 결과를 대화로 물어볼 수 있고, 원하면 구매·충전까지 열 수 있어요. 다만 실제로 사는 건 매번 직접 승인하셔야 해요.

게이트는 .env에 적어도 안 열려요. -e 옵션이나 Desktop 설정의 env 블록처럼 서버를 띄우는 프로세스 환경에 넣어야 해요. .env는 모델이 고칠 수 있는 파일이거든요. 거기서 스위치를 읽으면 "모델이 못 건드리는 곳에 스위치를 둔다"는 전제가 무너져요.

게이트는 서버가 뜰 때 한 번 읽고 끝이에요. 나중에 켜거나 끄려면 등록을 지우고 다시 만든 뒤 클라이언트를 재시작하세요 (claude mcp remove klottery).

- macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json - Windows: %APPDATA%\Claude\claudedesktopconfig.json

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/rajephon--k-lottery.html)

Related MCP servers