Gumroad MCP Server

<a href="https://smithery.ai/server/@rmarescu/gumroad-mcp"><img alt="Smithery 徽章" src="https://smithery.ai/badge/@rmarescu/gumroad-mcp"></a> <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 Server 和 Claude Desktop：

npx gumroad-mcp@latest init

此命令通过交互式提示设置 MCP 服务器，并使用您的 [Gumroad 凭据](#生成一个 Gumroad 访问令牌)。

使用方法

一旦配置完成，可以在您的 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 自动安装 gumroad-mcp 到 Claude Desktop：

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（本地主机），因为在此上下文中该值没有实际意义。
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"
      }
    }
  }
}

[!NOTE] 服务器会自动在其基础 URL 后面追加 API 版本（/v2）。例如，当 GUMROAD_BASE_URL="https://example.com" 时，API 请求将发送到 https://example.com/v2。

请参阅这些 指南 了解如何将 MCP 服务器添加到 Claude Desktop。

贡献

发现了一个错误或想提出一个功能建议？请在 GitHub 上打开一个问题或提交一个拉取请求。

许可证

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