使用说明
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
Installation
pip install mcp requests
MCP Tools
| Tool | Description |
|---|---|
update_lottery |
Update lottery data to local database |
query_lottery |
Query lottery results by date range |
check_prize |
Check winning status for given numbers |
get_latest_results |
Get recent lottery results |
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
| Variable | Description | Default |
|---|---|---|
LOTTERY_DATA_DIR |
Directory to store lottery data | ~/lottery_data |
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
| Type | ID | Description | Numbers |
|---|---|---|---|
double_ball |
双色球 | Double Color Ball | 6 red (1-33) + 1 blue (1-16) |
super_lotto |
大乐透 | Super Lotto | 5 front (1-35) + 2 back (1-12) |
Prize Levels
Double Color Ball (双色球)
| Level | Red Match | Blue Match |
|---|---|---|
| 一等奖 | 6 | ✓ |
| 二等奖 | 6 | ✗ |
| 三等奖 | 5 | ✓ |
| 四等奖 | 5 or 4+blue | - |
| 五等奖 | 4 or 3+blue | - |
| 六等奖 | 0-2 | ✓ |
Super Lotto (大乐透)
| Level | Front Match | Back Match |
|---|---|---|
| 一等奖 | 5 | 2 |
| 二等奖 | 5 | 1 |
| 三等奖 | 5 | 0 |
| 四等奖 | 4 | 2 |
| 五等奖 | 4 | 1 |
| 六等奖 | 3 | 2 |
| 七等奖 | 4+0 or 3+1 | - |
| 八等奖 | Various combinations | - |
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.