发票对奖服务

🧾 台灣統一發票助手 (mcp-tw-invoice)

這是一個基於 FastMCP 框架開發的 Model Context Protocol (MCP) 伺服器，支援查詢台灣統一發票中獎號碼與自動對獎。

✨ 特點

• FastMCP 架構：使用最新 FastMCP 框架，程式碼簡潔且效能穩定。
• 雙傳輸模式：同時支援 stdio (本機) 與 streamable-http (遠端/Docker) 模式。
• 自動對獎：輸入末 3 碼或完整 8 碼即可判斷是否中獎。

🚀 傳輸模式 (Transport Modes)

1. 本機模式 (STDIO) - 預設

適合在個人電腦上與 Claude Desktop 搭配使用。

python src/server.py --mode stdio

2. 遠端模式 (HTTP)

適合 Docker 部署與 Dive 客戶端連線。

python src/server.py --mode http --port 8000

• 服務 URL: http://localhost:8000/mcp

🛠️ 安裝與啟動

1. 本機安裝

pip install .

2. Docker 啟動 (推薦)

docker build -t mcp-tw-invoice .
docker run -p 8000:8000 mcp-tw-invoice

🔌 客戶端配置範例

Claude Desktop (STDIO)

{
  "mcpServers": {
    "tw-invoice": {
      "command": "python",
      "args": ["/絕對路徑/src/server.py", "--mode", "stdio"]
    }
  }
}

Dive / HTTP 客戶端

• Type: streamable
• URL: http://localhost:8000/mcp

📄 免責聲明

本工具提供之資訊僅供參考，中獎號碼請以財政部稅務入口網公佈之資料為準。