MCP 服务器

Gumroad MCP Server

Gumroad API 的模型上下文协议 (MCP) 服务器实现

rmarescu

开发者工具

README

Gumroad MCP 服务器

<video src="https://gist.github.com/user-attachments/assets/3750b072-053c-40a0-9c89-361f861350db" controls autoplay loop muted> 您的浏览器不支持 video 标签。 </video>

概述

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

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

快速开始

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

npx gumroad-mcp@latest init

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

用法

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

我上个月的销售额与一年前相比如何？
生成一个包含去年销售额的交互式图表
列出我去年在 Gumroad 上最畅销的产品
显示我去年最畅销产品的月度趋势
禁用“产品名称”产品
启用“产品名称”产品
列出“产品名称”的所有优惠码
为“产品名称”创建一个新的 99% 折扣的优惠码“FAFO”
从“产品名称”中删除优惠码“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 - 获取已验证的用户数据

安装

前提条件

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