Gumroad MCP服务

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

ecommerce-and-retailmarketing

359 查看 · 2026-07-07 更新

简介

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

简介

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

Gumroad MCP 服务器

概览

这是一个用于 Gumroad 的模型上下文协议 (MCP) 服务器实现，使像 Claude Desktop 这样的兼容 MCP 的 AI 客户端能够与 Gumroad API 交互。

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

快速开始

几秒钟内通过 Claude Desktop 开始使用 Gumroad MCP 服务器：

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实例）：Log in
转到设置 > 高级页面。
通过提供以下信息来创建一个新的应用程序：
- 应用程序图标（可选）：一个小的缩略图以标识您的应用程序。
- 应用程序名称：为您的应用程序命名。
- 重定向URI：对于个人使用，您可以输入 http://127.0.0.1 （本地主机），因为在此上下文中这个值没有实际意义。
点击“创建应用程序”。
使用“生成访问令牌”按钮获取您的访问令牌。

请像保护密码一样安全且保密地保管您的访问令牌。您需要按照如下方式将其包含在配置中。

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"
      }
    }
  }
}

[!NOTE] 服务器会自动将API版本（/v2）附加到您的基础URL后面。例如，如果设置了GUMROAD_BASE_URL="https://example.com"，则API请求将会发送到https://example.com/v2。

请参考这些说明了解如何向Claude Desktop添加MCP服务器。

贡献

发现了错误或者想要建议新功能？请在GitHub上打开一个issue或提交pull request。

许可证

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

服务配置

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

来源

来源：github
链接：https://github.com/rmarescu/gumroad-mcp