AI导哈

Gumroad MCP服务器

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

  • by rmarescu
  • TypeScript
  • 本地部署
  • 31 星标
  • 更新于
在 GitHub 查看 rmarescu/gumroad-mcp

使用说明

Gumroad MCP服务器

概述

一种模型上下文协议（MCP）服务器实现 Gumroad，使兼容MCP的AI客户端（如Claude Desktop）能够与 API Gumroad.

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

快速启动

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

npx gumroad-mcp@latest init

此命令使用您的 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安装

通过以下方式自动安装克劳德桌面版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帐户（或您自己的Gumrade实例）。
  2. 转到设置> 高级 页面。
  3. 通过提供以下信息创建新应用程序：
    • 应用程序图标（可选）：用于标识应用程序的小缩略图。
    • 应用程序名称：应用程序的名称。
    • 重定向URI：对于个人使用，您可以输入 http://127.0.0.1 （localhost），因为此值在此上下文中没有意义。
  4. 单击“创建应用程序”
  5. 使用“生成访问令牌”按钮获取您的访问令牌。

确保您的访问令牌安全保密，就像密码一样。您需要将其包含在配置中，如下所示。

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实例，则可以配置服务器通过以下方式连接到您的自定义URL GUMROAD_BASE_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。

贡献

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

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

相关 MCP