Lottery MCP Server

A Model Context Protocol (MCP) server for Chinese lottery data query and prize checking. Supports 双色球 (Double Color Ball) and 大乐透 (Super Lotto).

Features

• 🔄 Update lottery data - Fetch latest lottery results from official sources

• 🔍 Query results - Search lottery results by date range

• 🎯 Check prizes - Check if your numbers won any prizes

• 📊 Get latest results - Quick access to recent lottery draws

Related MCP server: Chinese Tourism Spots MCP Server

Installation

pip install mcp requests

MCP Tools

Configuration

Add to your MCP config (e.g., .kiro/settings/mcp.json):

{
  "mcpServers": {
    "lottery": {
      "command": "python",
      "args": ["/path/to/lottery_mcp_server.py"],
      "env": {
        "LOTTERY_DATA_DIR": "/path/to/data"
      },
      "disabled": false,
      "autoApprove": ["update_lottery", "query_lottery", "check_prize", "get_latest_results"]
    }
  }
}

Environment Variables

Usage Examples

Update lottery data

update_lottery("double_ball", "2025-12-01", "2026-01-18")
update_lottery("super_lotto", "2025-12-01", "2026-01-18")

Query results

query_lottery("double_ball", "2025-12-01", "2026-01-18")

Check prize (Double Color Ball: 6 red + 1 blue)

check_prize("double_ball", "2025-12-01", "2026-01-18", [3, 11, 14, 19, 29, 30, 15])

Check prize (Super Lotto: 5 front + 2 back)

check_prize("super_lotto", "2025-12-01", "2026-01-18", [8, 13, 27, 30, 32, 2, 3])

Get latest results

get_latest_results("double_ball", 5)
get_latest_results("super_lotto", 10)

Lottery Types

Prize Levels

Double Color Ball (双色球)

Super Lotto (大乐透)

Data Source

Data is fetched from 中国福彩网:

• 双色球: https://www.zhcw.com/kjxx/ssq/

• 大乐透: https://www.zhcw.com/kjxx/dlt/

License

MIT License

Disclaimer

This tool is for educational and entertainment purposes only. Please gamble responsibly.