🚀 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 文件。