lottery-mcp-server

Lumosylva/lottery-mcp-server

3.3

If you are the rightful owner of lottery-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This is a Model Context Protocol (MCP) server for querying historical data of the Double Color Ball lottery, providing data from 2013 to the present.

Tools
5
Resources
0
Prompts
0

双色球彩票 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的双色球彩票历史数据查询服务器，提供从2013年至今的所有一等奖开奖数据。

功能特性

提供7个MCP工具：

  1. get_all_lottery_history - 获取所有历史一等奖数据
  2. get_lottery_by_date_range - 按日期范围查询开奖数据
  3. get_lottery_by_code - 按期号查询开奖数据
  4. get_latest_lottery - 获取最新N期开奖数据
  5. analyze_and_predict - 分析历史数据并基于高频号码生成参考号码（仅供参考）
  6. calculate_sum_value - 计算最近N期开奖号码的和值（红球号码之和）
  7. calculate_ac_value - 计算最近N期开奖号码的AC值（算术复杂性）

数据格式

每条记录包含以下字段：

{
  "date": "2025-11-16(日)",
  "code": "2025132",
  "red": "04,08,10,21,23,32",
  "blue": "11"
}

安装依赖

npm install

Cookie 自动管理

本项目实现了自动化的Cookie管理系统：

主要特点

  • ✅ 自动获取：首次运行时自动获取有效的Cookie
  • ✅ 自动缓存：Cookie保存到 cookie-cache.json
  • ✅ 自动刷新：Cookie过期（2小时）后自动获取新的
  • ✅ 无需手动配置：无需手动更新Cookie值

手动更新Cookie

如果需要手动更新Cookie，运行：

node get-cookie.js

该命令会：

  1. 获取最新的有效Cookie
  2. 验证Cookie是否可用（通过API测试）
  3. 自动保存到 cookie-cache.json
  4. 显示Cookie的有效期

数据缓存管理

本项目实现了智能的数据缓存系统，大幅减少API调用频率：

缓存策略

  • ✅ 双层缓存：内存缓存（二级）+ 文件缓存（一级）
  • ✅ 自然日缓存：同一自然日内的缓存有效
  • ✅ 开奖日智能处理：
    • 非开奖日（周一、周三、周五、周六）：全天使用缓存
    • 开奖日（周二、周四、周日）：
      • 21:15:00之前：使用缓存
      • 21:15:00之后：获取新数据（因为有新的开奖结果）

缓存文件

  • 位置：lottery-data-cache.json
  • 内容：包含完整的开奖数据、缓存日期和时间戳

缓存流程

  1. 首先检查内存缓存（最快）
  2. 其次检查文件缓存（快速）
  3. 最后从API获取新数据（自动保存到文件缓存）

使用方法

开发模式

npm run dev

编译

npm run build

生产模式

npm start

提问示例

@lottery 给出最近5期的双色球开奖号码 question_one

@lottery 进行全历史统计分析并生成10组推荐号码 question2 question2 question2

@lottery 计算最近10期的和值 question3 question3

@lottery 计算最近10期的AC值 question4 question4

MCP工具说明

1. get_all_lottery_history

获取所有历史开奖数据（2013年至今）

参数：无

返回：LotteryData数组

2. get_lottery_by_date_range

按日期范围查询开奖数据

参数：

  • startDate (string): 开始日期，格式 YYYY-MM-DD，例如 "2025-01-01"
  • endDate (string): 结束日期，格式 YYYY-MM-DD，例如 "2025-12-31"

返回：符合日期范围的LotteryData数组

3. get_lottery_by_code

按期号查询开奖数据

参数：

  • code (string): 期号，例如 "2025132"

返回：单条LotteryData或null（未找到）

4. get_latest_lottery

获取最新N期开奖数据

参数：

  • count (number, 可选): 获取期数，默认10

返回：最新N期的LotteryData数组

5. analyze_and_predict

分析历史数据并基于统计规律生成推荐号码

参数：无

返回：AnalysisResult对象，包含：

  • totalDraws: 总开奖期数
  • redBallStats: 红球频率统计（前20个高频号码）
  • blueBallStats: 蓝球频率统计（前10个高频号码）
  • recommendations: 10组推荐号码组合
  • disclaimer: 重要提醒声明

推荐号码生成规则：

  1. 号码池选择

    • 红球：选择历史出现频率最高的前20个红球作为候选
    • 蓝球：选择历史出现频率最高的前8个蓝球作为候选

  2. 排除历史开奖号码

    • 确保推荐的号码组合不曾在历史开奖数据中出现过

  3. 和值控制

    • 红球和值严格控制在60-140之间
    • 这是基于100%的历史开奖号码都落在此区间的统计结果

  4. AC值控制

    • AC值严格控制在7-9之间
    • 这是基于超过85%的历史开奖号码AC值落在此区间的统计结果
    • AC值计算公式：不同差值的个数 - (6 - 1)

  5. 生成过程

    • 从高频红球池中随机选择6个不重复的号码
    • 从高频蓝球池中随机选择1个号码
    • 检查组合是否满足所有条件
    • 重复生成直到获得10组有效组合或达到最大尝试次数

返回示例：

{
  "totalDraws": 1500,
  "redBallStats": [
    { "number": "07", "count": 245, "percentage": 16.33 },
    ...
  ],
  "blueBallStats": [
    { "number": "12", "count": 120, "percentage": 8.00 },
    ...
  ],
  "recommendations": [
    { "red": "01,07,12,23,26,32", "blue": "12" },
    ...
  ],
  "disclaimer": "⚠️ 重要提醒：彩票开奖是完全随机的..."
}

统计参考：

  • 和值范围：60-140（100%覆盖历史开奖）
  • AC值范围：7-9（覆盖85%以上历史开奖）
  • 号码选择：基于历史频率，优先选择高频号码

重要说明：

  • 此工具基于历史数据统计规律生成号码
  • 所有推荐号码都经过严格的条件筛选
  • 彩票开奖是完全随机的，历史数据不能预测未来
  • 任何号码组合的中奖概率都是相同的（约1/17,721,088）
  • 请理性购彩，切勿沉迷

6. calculate_sum_value

计算最近N期开奖号码的和值（红球号码之和）

参数：

  • count (number, 可选): 期数，默认10

返回：SumValueResult对象，包含：

  • count: 计算的期数
  • data: 每期的开奖号码和对应的和值
  • statistics: 统计信息
    • averageSumValue: 平均和值
    • minSumValue: 最小和值
    • maxSumValue: 最大和值
    • standardDeviation: 标准差

返回示例：

{
  "count": 10,
  "data": [
    {
      "date": "2025-12-04(四)",
      "code": "2025140",
      "red": "01,03,04,12,18,24",
      "sumValue": 62
    },
    ...
  ],
  "statistics": {
    "averageSumValue": 115.5,
    "minSumValue": 62,
    "maxSumValue": 168,
    "standardDeviation": 35.2
  }
}

和值分析意义：

  • 理论最小和值：21（1+2+3+4+5+6）
  • 理论最大和值：183（28+29+30+31+32+33）
  • 实战常见范围：80-140（约90%的开奖号码落在此区间）
  • 和值反映号码整体的"大小"倾向

7. calculate_ac_value

计算最近N期开奖号码的AC值（算术复杂性）

参数：

  • count (number, 可选): 期数，默认10

返回：ACValueResult对象，包含：

  • count: 计算的期数
  • data: 每期的开奖号码和对应的AC值
  • statistics: 统计信息
    • averageACValue: 平均AC值
    • minACValue: 最小AC值
    • maxACValue: 最大AC值
    • distribution: AC值分布（各AC值出现的次数）

返回示例：

{
  "count": 10,
  "data": [
    {
      "date": "2025-12-04(四)",
      "code": "2025140",
      "red": "01,03,04,12,18,24",
      "acValue": 8
    },
    ...
  ],
  "statistics": {
    "averageACValue": 7.8,
    "minACValue": 6,
    "maxACValue": 9,
    "distribution": {
      "6": 1,
      "7": 3,
      "8": 4,
      "9": 2
    }
  }
}

AC值分析意义：

  • AC值 = 不同差值的个数 - (号码数量 - 1)
  • 反映号码的离散程度和结构复杂性
  • 理论最小值：0（号码极其规律，如01,02,03,04,05,06）
  • 理论最大值：10（号码极度分散）
  • 黄金实战区间：7, 8, 9（超过85%的开奖号码AC值落在此区间）
  • AC值过低（<5）或过高（10）的组合中奖概率极低

配置MCP客户端

在你的MCP客户端配置文件中添加：

{
  "mcpServers": {
    "lottery": {
      "command": "node",
      "args": ["d:/Project/nodejs/lottery-mcp-server/dist/server.js"]
    }
  }
}

或使用开发模式：

{
  "mcpServers": {
    "lottery": {
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "d:/Project/nodejs/lottery-mcp-server"
    }
  }
}

技术栈

  • TypeScript
  • Node.js
  • @modelcontextprotocol/sdk
  • HTTPS (内置模块)

数据来源

数据来自中国福利彩票官方网站

注意事项

  • 服务器首次请求时会从API获取数据并缓存
  • 后续查询将使用缓存数据，提高响应速度
  • 数据包含从2013-01-01到最新一期的所有开奖记录