Gumroad MCP 服务器

概述

一个用于 Gumroad 的 Model Context Protocol (MCP) 服务器实现，使 MCP 兼容的 AI 客户端（如 Claude Desktop）能够与 Gumroad API 进行交互。

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

快速入门

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

npx gumroad-mcp@latest init

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

使用方法

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

• 我上个月的销售额与一年前相比如何？
• 生成去年销售额的交互式图表
• 列出去年的 Gumroad 销售情况
• 查看过去七天的销售数据

更多示例请参考 Gumroad 文档。

工具

基本功能

• 初始化：npx gumroad-mcp@latest init
• 获取凭据：npx gumroad-mcp@latest credentials
• 列出产品：npx gumroad-mcp@latest products
• 订单历史：npx gumroad-mcp@latest orders

高级功能

• 自定义字段：支持扩展数据字段
• 批量处理：支持一次性处理多个订单
• 过滤器：通过日期、产品 ID 等条件筛选数据
• 导出：将数据导出为 CSV 或 JSON 格式

安装指南

基本安装

对于大多数用户，运行以下命令即可：

npx gumroad-mcp@latest install

手动安装

如果您需要自定义配置，请参考以下示例：

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

如果您使用的是自托管的 Gumroad 实例，可以通过 GUMROAD_BASE_URL 配置自定义地址：

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

注意
服务器会自动在基础 URL 后附加 API 版本（/v2）。例如，使用 GUMROAD_BASE_URL="https://example.com"，API 请求将发送到 https://example.com/v2。

请参考 MCP 协议文档 了解如何在 Claude Desktop 中添加 MCP 服务器。

贡献

发现错误或有任何建议？请在 GitHub 上打开问题或提交拉取请求。

许可证

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