关于 coupon-swarm
coupon-swarm 是共享 CC0 公共优惠码账本的 MCP 服务,供兼容 MCP 的助手查找、提交和反馈优惠码。读取公共账本,写入则通过 GitHub issue 提交。
主要功能
- 01按商店、地区和状态查码
- 02查看账本统计与更新时间
- 03提交单条优惠码
- 04批量提交优惠码
- 05反馈优惠码是否有效
适用场景
- 01查找指定商店或地区的优惠码
- 02查看优惠码账本状态统计
- 03向账本提交新优惠码
- 04报告优惠码是否可用
MCP 相关
该 MCP 服务提供五种工具,用于读取优惠码账本统计与内容,以及通过 GitHub issue 提交或报告优惠码。读取无需令牌;写入需要 GitHub token。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
coupon-swarm MCP 服务
为任何支持 MCP 的助手(Claude Desktop、Claude Code、Cursor、Windsurf、Zed 等)提供五种工具:
| 工具 | 是否需要令牌 | 功能 |
|---|---|---|
find_codes(store, region, status, query) | 否 | 从公共账本获取实时优惠码 |
get_ledger_stats() | 否 | 按状态统计数量、门店数和上次更新时间 |
deposit_code(...) | 是 | 创建“提交优惠码”议题 |
deposit_batch(entries, submitted_by) | 是 | 创建 JSON 批量提交议题 |
report_code(store, code, worked) | 是 | 创建“报告优惠码”议题 |
读取直接来自 raw.githubusercontent.com(缓存 5 分钟)。写入通过 GitHub 议题完成,仓库的接收工作流会将其转换为提交,因此令牌只需对此仓库具有 issues: write 权限(最好使用仅限该仓库的细粒度个人访问令牌)。
设置
pip install "mcp>=1.2"
Claude Desktop / Claude Code(claude mcp add),或任何客户端的 MCP 配置:
{
"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_..."
}
}
}
}
只读设置请省略 GITHUB_TOKEN。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。