coupon-swarm

coupon-swarm MCP サーバー

MCP 対応アシスタント（Claude Desktop、Claude Code、Cursor、Windsurf、Zed など）に、次の 5 つのツールを提供します。

ツール	トークンが必要	機能
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 を省略してください。