Lotto MCP Server

乐透MCP服务器

模型上下文协议（MCP）服务器，可在同行彩票中自动购买彩票并查看中奖结果。

📋 功能

• 乐透自动购买：登录同行彩票账号自动购买乐透
• 确认中奖结果：自动确认购买乐透号码的中奖结果
• 增强的安全性：通过加密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使用方法 请参考。

方法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桌面

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桌面设置

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

注意事项

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许可证

🤝 贡献

请将错误报告或功能建议登记为问题。

法律告知

该工具不使用同行彩票的官方API，而是通过Web抓取操作。用户对使用负有全部责任，对因过度使用而受到的帐户制裁或其他问题不承担责任。