Gumroad MCP

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