Gumroad MCP Server

Gumroad MCP 服务

您的浏览器不支持 video 标签。

概述

这是 Gumroad 的模型上下文协议（MCP）服务实现，可让 Claude Desktop 等兼容 MCP 的 AI 客户端与 Gumroad API 交互。

模型上下文协议（MCP） 允许 AI 助手与外部工具和服务交互。

快速开始

几秒钟内即可开始在 Claude Desktop 中使用 Gumroad MCP 服务：

npx gumroad-mcp@latest init

此命令会通过交互式提示，使用您的 Gumroad 凭据 配置 MCP 服务。

使用方法

配置完成后，可在兼容 MCP 的客户端中尝试以下命令：

• 去年上个月与一年前的同期相比，我的销售额是多少？
• 生成一张展示去年销售额的交互式图表
• 列出我去年在 Gumroad 上最畅销的产品
• 显示去年我最畅销产品的月环比趋势
• 停用“Product Name”产品
• 启用“Product Name”产品
• 列出“Product Name”的所有优惠码
• 为“Product Name”创建一个新的优惠码“FAFO”，折扣为 99%
• 删除“Product Name”的优惠码“abc123”

工具

产品

• gumroad_get_products - 获取所有产品
• gumroad_get_product - 根据 ID 获取单个产品
• gumroad_disable_product - 停用产品
• gumroad_enable_product - 启用产品

销售

• gumroad_get_sales - 获取销售数据

优惠码

• gumroad_get_offer_codes - 获取某个产品的所有优惠码
• gumroad_get_offer_code - 获取单个优惠码
• gumroad_create_offer_code - 创建新的优惠码
• gumroad_update_offer_code - 更新现有优惠码
• gumroad_delete_offer_code - 删除优惠码

用户

• gumroad_get_user - 获取已通过身份验证的用户数据

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 gumroad-mcp：

npx -y @smithery/cli install @rmarescu/gumroad-mcp --client claude

先决条件

• Node.js 18 或更高版本
• 拥有 API 访问权限的 Gumroad 账户
• 兼容 MCP 的客户端（例如 Claude Desktop）

若要确认已安装 Node，请在电脑上打开命令行。

• 在 macOS 上，从“应用程序”文件夹打开“终端”
• 在 Windows 上，按 Windows + R，输入“cmd”，然后按 Enter

打开命令行后，输入以下命令以确认已安装 Node：

node --version

生成 Gumroad 访问令牌

Gumroad API 需要身份验证。若要生成访问令牌，请按以下步骤操作：

1. 登录您的 Gumroad 账户（或您自己的 Gumroad 实例）。
2. 前往“设置” > 高级页面。
3. 提供以下信息以创建新应用：
   • 应用图标（可选）：用于识别应用的小型缩略图。
   • 应用名称：为应用设置的名称。
   • 重定向 URI：个人使用时，可填写 http://127.0.0.1（localhost），因为在此情况下该值没有实际意义。
4. 点击“创建应用”。
5. 使用“生成访问令牌”按钮获取访问令牌。

请像密码一样妥善保管访问令牌并对其保密。您需要将其加入配置中，如下所示。

Claude Desktop 安装

如果您使用 Claude Desktop，可以使用交互式设置：

npx gumroad-mcp@latest init

手动安装

对于其他支持 MCP 的应用程序，你需要手动更新 MCP 配置。

配置示例

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

如果你使用的是自托管的 Gumroad 实例，可以通过 GUMROAD_BASE_URL 配置服务连接到你的自定义 URL：

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GUMROAD_BASE_URL": "https://example.com"
      }
    }
  }
}

说明

服务会自动将 API 版本（/v2）附加到基础 URL。例如，设置 GUMROAD_BASE_URL="https://example.com" 后，API 请求将发送到 https://example.com/v2。

请参阅这些说明，了解如何将 MCP 服务添加到 Claude Desktop。

贡献

发现了 Bug 或想建议新功能？请在 GitHub 上提交 issue 或拉取请求。

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。