Taiwan Lottery MCP server

mcp-server-taiwan-lottery

讓 AI 助理和程式直接查台灣彩券的官方開獎結果：最新一期、歷史開獎、對獎、號碼出現次數、開獎時間。號碼全部來自台灣彩券官方 API，查不到就說查不到，不會自己補。

說明與完整開獎資料：playsport539.com

一個套件兩種用法：MCP 伺服器（給 Claude 這類 AI 助理用），以及指令列工具 taiwan-lottery（給腳本、排程用）。

能做什麼

• 查某個遊戲最新一期的號碼、特別號（大樂透）或第二區（威力彩）、本期各獎項的中獎注數與每注獎金
• 用期別或日期查某一期；那天沒開獎會直接告訴你哪幾天才開
• 列出某個月，或最近 N 期的號碼
• 對獎：輸入你的號碼，回答對中哪幾個、是哪一個獎項，並附上官方的中獎條件原文
• 統計最近 N 期每個號碼出現幾次、隔了幾期沒開
• 開獎日、開獎時間，以及官方 API 給的下一期開獎日

每個結果都有 more 欄位，附 1 到 3 個 playsport539.com 的相關頁面（歷史開獎、統計、對獎、開獎時間），想看完整資料可以點過去。先說清楚：playsport539.com 是一個台灣彩券開獎與運動比分網站，網站上有廣告。

想直接在網頁上看，常用的幾頁：

• 各彩種今日開獎號碼
• 今彩539 歷史開獎
• 今彩539 號碼出現次數
• 大樂透線上對獎
• 威力彩號碼統計

支援的遊戲

中文名稱直接打就可以，例如「今彩539」「大樂透」「威力彩」；簡體（大乐透、宾果）與「三星」「四星」「威力」這種簡稱也認得。「樂透」這種泛稱不認，因為分不出是哪一個遊戲。

安裝

不需要任何 API 金鑰。建議用 Node.js 20 以上。

Node.js 18 也能跑，但安裝時會看到 EBADENGINE 警告：官方 MCP SDK（@modelcontextprotocol/sdk）帶進來的 @hono/node-server 標註要 Node.js 20 以上。這個套件只用 stdio 連線，不會載入它，所以警告不影響執行（把它整個刪掉再跑伺服器與指令列的測試，結果照樣全過）。如果你的 npm 開了 engine-strict，Node.js 18 會直接裝不起來（npm 文件：開了 engine-strict 就拒絕安裝標註不相容目前 Node.js 版本的套件）。

Claude Desktop

在 claudedesktopconfig.json 加上：

{
  "mcpServers": {
    "taiwan-lottery": { "command": "npx", "args": ["-y", "mcp-server-taiwan-lottery"] }
  }
}

Claude Code

claude mcp add taiwan-lottery -- npx -y mcp-server-taiwan-lottery

指令列

npx -y -p mcp-server-taiwan-lottery taiwan-lottery latest 539

或是 npm install -g mcp-server-taiwan-lottery 之後直接打 taiwan-lottery。

指令列範例

以下都是實際執行的輸出（2026-10-23 早上，台灣時間）。

$ taiwan-lottery latest 539
今彩539　第 115000256 期　2026-10-22（週四）
開獎號碼（由小到大）：03 08 14 23 28
開出順序：03 28 23 14 08
獎項（本期官方公布）：
  頭獎          4 注　每注 6,000,000 元
  貳獎        249 注　每注 20,000 元
  參獎      7,153 注　每注 300 元
  肆獎     74,792 注　每注 50 元
銷售金額：32,953,350 元
兌獎期限：2027-01-22

說明：
  - 官方資料不是即時的：台灣彩券官網常見問題寫明每晚 21:30 公告當日獎號、22:00 公告開獎結果（各獎項注數與獎金）。21:30 以前查不到當期是正常的，22:00 以前可能還沒有獎金資料。
  - 資料取自台灣彩券官方 API，一切以台灣彩券官方公告為準。

更多：
  今彩539開獎號碼  https://playsport539.com/lottery/539/
  今彩539歷史開獎  https://playsport539.com/lottery/539/history/

$ taiwan-lottery check 大樂透 02 05 19 07 11 25
大樂透　第 115000098 期　2026-10-20
你的號碼：02 05 19 07 11 25
開獎號碼：02 05 19 33 40 43　特別號 06
對中：02 05 19（3 個）
結果：普獎（對中當期獎號之任三碼）
本期普獎每注：400 元（官方公布）

說明：
  - 沒有指定期別，這裡對的是官方資料裡最新的一期（第 115000098 期，2026-10-20）。請確認和彩券上的期別相同。
  - 官方資料不是即時的：台灣彩券官網常見問題寫明每晚 21:30 公告當日獎號、22:00 公告開獎結果（各獎項注數與獎金）。21:30 以前查不到當期是正常的，22:00 以前可能還沒有獎金資料。
  - 對獎結果僅供參考，兌獎以彩券本身及台灣彩券官方兌獎結果為準。
  - 資料取自台灣彩券官方 API，一切以台灣彩券官方公告為準。

更多：
  大樂透對獎  https://playsport539.com/lottery/lotto649/check/
  大樂透玩法與獎項  https://playsport539.com/lottery/lotto649/rules/
  大樂透開獎號碼  https://playsport539.com/lottery/lotto649/

$ taiwan-lottery schedule 威力彩
威力彩 開獎時間
開獎日：週一、週四
時間：20:30（台灣時間）
下一期：2026-10-26（週一）　第 115000086 期
官網公布：台灣彩券官網每晚 21:30 公告當日獎號、22:00 公告開獎結果
來源：https://www.taiwanlottery.com/run_lottery/schedule/ https://www.taiwanlottery.com/customer_service/faq/

說明：
  - 官方資料不是即時的：台灣彩券官網常見問題寫明每晚 21:30 公告當日獎號、22:00 公告開獎結果（各獎項注數與獎金）。21:30 以前查不到當期是正常的，22:00 以前可能還沒有獎金資料。
  - 資料取自台灣彩券官方 API，一切以台灣彩券官方公告為準。

Shortened. The full README is on GitHub.