Coupon Swarm

io.github.Geo-Coder-17v0.1.0更新於 Oct 4, 2026

Shared CC0 ledger of public coupon codes with dates: find, deposit and report codes.

已驗證STDIO僅桌面Business & CommerceProductivity & Workflow

概覽

AI 產生的概覽

讓助理從共享的 CC0 優惠碼帳本查詢公開優惠碼，並以 GitHub issue 形式提交新碼或回報。

功能
圍繞共享的公開優惠碼帳本提供五個工具。find_codes 可依商店、地區、狀態或關鍵字回傳有效優惠碼，get_ledger_stats 提供各狀態數量、商店總數與最後更新時間。deposit_code、deposit_batch 與 report_code 會建立 GitHub issue，再由倉庫的接收流程轉成提交。
適用情境
適合讓助理依據社群維護的清單回答優惠碼或折扣碼問題，也適合在不離開對話的情況下，對該清單貢獻優惠碼以及可用或不可用的回報。
執行需求
以 stdio 方式在使用者機器本機執行 Python 程序；需要 Python 與 mcp 套件（pip install "mcp>=1.2"），並在用戶端的 MCP 設定中指向該伺服器指令碼。讀取依賴 raw.githubusercontent.com，因此需要網路存取。寫入類工具需要對目標倉庫具備 issues: write 權限的 GITHUB_TOKEN，以及 COUPON_SWARM_REPO；僅唯讀使用時可省略該權杖。
安裝前請注意
寫入類工具會建立公開的 GitHub issue，提交內容將在倉庫中公開且長期可見。GITHUB_TOKEN 屬於憑證：建議使用僅限該倉庫 issues: write 權限的細粒度個人存取權杖，並避免放入共用設定。優惠碼來自第三方公開帳本，可能已過期、無效或具誤導性。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Coupon Swarm，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

coupon-swarm MCP server

Gives any MCP-capable assistant (Claude Desktop, Claude Code, Cursor, Windsurf, Zed, …) five tools:

ToolNeeds a tokenWhat it does
find_codes(store, region, status, query)nolive codes from the public ledger
get_ledger_stats()nocounts per status, number of stores, last update
deposit_code(...)yesopens a "Deposit a coupon code" issue
deposit_batch(entries, submitted_by)yesopens a JSON-batch issue
report_code(store, code, worked)yesopens a "Report a code" issue

Reads come straight from raw.githubusercontent.com (cached 5 minutes). Writes go through GitHub issues, which the repo's intake workflow turns into commits, so the token only needs issues: write on this one repo (a fine-grained personal access token scoped to the repo is ideal).

Setup

bash
pip install "mcp>=1.2"

Claude Desktop / Claude Code (claude mcp add), or any client's MCP config:

json
{  "mcpServers": {    "coupon-swarm": {      "command": "python",      "args": ["/path/to/coupon-swarm/mcp/server.py"],      "env": {        "COUPON_SWARM_REPO": "Geo-Coder-17/coupon-swarm",        "GITHUB_TOKEN": "github_pat_..."      }    }  }}

Leave out GITHUB_TOKEN for a read-only setup.

來源：mcp/README.md，提交 d8a5fdf

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 4, 2026