GumroadDNA

GumroadDNA MCP

在聊天中使用 Gumroad API v2：产品、文件、销售、退款、许可证，以及细分市场扫描。

GumroadDNA 为你的 AI 提供 44 个 Gumroad API v2 工具：端到端创建产品（文件、封面、缩略图、发布）、更新、发布和归档产品，管理产品图片，列出销售记录并退款，重新发送收据，将订单标记为已发货，读取订阅者，验证和切换许可证密钥，管理优惠码、自定义字段和 Webhook，并获取今日、本周和本月的收入概览。它还会读取任意关键词对应的公开 Gumroad 店面信息（产品数量、价格范围、按评分数排名的畅销产品），帮助你在进入某个细分市场前评估规模。

通过 Python 3.10+ 和你自己的 Gumroad 访问令牌，在本地使用 stdio 运行。免费。

主页：https://vibedna.ai/store/gumroad

工具（44）

类别	工具
市场调研	scan_gumroad_niche（公开店面，无需令牌）
产品	create_product、launch_product、update_product、publish_product、archive_product、list_products、download_product_files
文件和图片	add_product_file、set_product_cover、add_product_image、list_product_images、remove_product_image、reorder_product_images、download_product_images
销售	get_revenue_snapshot、list_sales、get_sale、refund_sale、resend_receipt、mark_as_shipped
订阅者	list_subscribers、get_subscriber
许可证密钥	verify_license、enable_license、disable_license、decrement_license_uses
折扣和结账	list_offer_codes、create_offer_code、delete_offer_code、list_custom_fields、create_custom_field、delete_custom_field
库存	get_stock_status、update_stock、bump_stock
Webhook	list_webhooks、create_webhook、delete_webhook
附加工具	scan_unlisted_assets（检查你提供的项目名称中哪些没有上架）、sync_buyers_to_resend（将唯一买家邮箱导出为列表；它本身不会调用 Resend）
账户和元信息	get_account、vibedna_info、check_for_update

refund_sale、archive_product、delete_offer_code、delete_webhook 和其他写入工具会对你的线上店铺执行操作。除非你已允许，否则 AI 客户端会在调用工具前征求你的同意。

安装

获取 Gumroad 访问令牌：app.gumroad.com/settings/advanced > Applications > Create application > Generate access token。

git clone https://github.com/marstudio360/gumroad-dna-mcp
cd gumroad-dna-mcp
pip install -r requirements.txt

令牌可以放在 MCP 条目中（如下），也可以放在 server.py 旁边的 .env 文件中（复制 .env.example）。

Claude Code

claude mcp add gumroad-dna --scope user -e GUMROAD_ACCESS_TOKEN=your_token -- python /absolute/path/to/gumroad-dna-mcp/server.py

也可以放在项目的 .mcp.json 中：

{
  "mcpServers": {
    "gumroad-dna": {
      "command": "python",
      "args": ["/absolute/path/to/gumroad-dna-mcp/server.py"],
      "env": { "GUMROAD_ACCESS_TOKEN": "your_token" }
    }
  }
}

Cursor

将相同的 mcpServers 块添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）中。

Claude Desktop

将相同的 mcpServers 块添加到 claude_desktop_config.json（Settings > Developer > Edit Config）中，然后重启 Claude Desktop。

INSTALL.md 是一份分步指南，你可以将其粘贴到 AI 聊天中，让 AI 帮你完成安装。

配置

变量	必需	用途
GUMROAD_ACCESS_TOKEN	是（scan_gumroad_niche 除外）	你的 Gumroad API 令牌
PORT	否	如果设置，则在该端口提供可流式传输的 HTTP 服务，而不是使用 stdio

网络

调用会使用你的令牌访问 api.gumroad.com，扫描细分市场时访问 gumroad.com/discover，且仅在调用 check_for_update 时访问 vibedna.ai/api/mcp/latest。

许可证

MIT，详见 LICENSE。版权所有 (c) 2026 VibeDNA。

支持：[email protected]