Gumroad MCP 服务器

您的浏览器不支持视频标签。

概述

Gumroad的模型上下文协议 (MCP) 服务器实现，使 MCP 兼容的 AI 客户端（如 Claude Desktop）能够与Gumroad 的 API进行交互。

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

快速入门

几秒钟内即可开始使用 Gumroad MCP Server 和 Claude Desktop：

npx gumroad-mcp@latest init

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

用法

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

与去年同期相比，我上个月的销售量是多少？
生成包含去年销售额的交互式图表
列出我去年在 Gumroad 上最畅销的产品
显示去年我最畅销产品的月度趋势
禁用“产品名称”产品
启用“产品名称”产品
列出“产品名称”的所有优惠代码
为“产品名称”创建新的优惠码“FAFO”，享受 99% 折扣
从“产品名称”中删除优惠码“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 需要身份验证。要生成访问令牌，请按照以下步骤操作：

登录您的 Gumroad 帐户（或您自己的 Gumroad 实例）。
转到设置>高级页面。
通过提供以下信息来创建新的应用程序：
- 应用程序图标（可选）：用于识别您的应用程序的小缩略图。
- 应用程序名称：您的应用程序的名称。
- 重定向 URI：对于个人使用，您可以输入http://127.0.0.1 (localhost)，因为此值在此上下文中没有意义。
点击“创建应用程序”。
使用“生成访问令牌”按钮获取您的访问令牌。

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

Claude桌面安装

如果您使用 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 上创建问题或提交拉取请求。

执照

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

Gumroad

Integrations