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