Gumroad MCP Server
2025.04.04
8
TypeScript销售管理产品管理优惠码管理金融服务
Gumroad MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现，专为 Gumroad 平台设计。它允许 MCP 兼容的 AI 客户端（如 Claude Desktop）通过 Gumroad 的 API 进行交互。该服务提供了对 Gumroad 产品、销售、优惠码和用户数据的访问和管理能力，使得用户可以通过 AI 客户端直接查询销售数据、管理产品和优惠码等。
View on GitHub
Overview
基本能力
产品定位
Gumroad MCP Server 是一个连接 AI 客户端与 Gumroad API 的中间件，旨在通过 MCP 协议扩展 AI 助手的功能，使其能够直接与 Gumroad 平台进行交互。
核心功能
- 产品管理：获取所有产品或单个产品信息，启用或禁用产品。
- 销售数据查询：获取销售数据，支持时间范围查询和比较。
- 优惠码管理：创建、更新、删除和查询产品优惠码。
- 用户信息获取：获取认证用户的基本信息。
适用场景
- 销售数据分析：查询历史销售数据，生成销售趋势图表。
- 产品管理：批量启用或禁用产品，管理产品状态。
- 营销活动：创建和管理优惠码，进行促销活动。
工具列表
- gumroad_get_products：获取所有产品。
- gumroad_get_product：获取单个产品信息。
- gumroad_disable_product：禁用产品。
- gumroad_enable_product：启用产品。
- gumroad_get_sales：获取销售数据。
- gumroad_get_offer_codes：获取产品所有优惠码。
- gumroad_create_offer_code：创建新优惠码。
- gumroad_update_offer_code：更新优惠码。
- gumroad_delete_offer_code：删除优惠码。
- gumroad_get_user：获取用户信息。
常见问题解答
- 如何生成 Gumroad 访问令牌？：登录 Gumroad 账户，进入高级设置页面创建应用并生成访问令牌。
- 如何配置自定义 Gumroad 实例？：通过设置
GUMROAD_BASE_URL环境变量指向自定义实例地址。
使用教程
使用依赖
- Node.js 18 或更高版本：
bash node --version - Gumroad 账户：需要具有 API 访问权限。
- MCP 兼容客户端：如 Claude Desktop。
安装教程
- 通过 npm 初始化：
bash npx gumroad-mcp@latest init - 手动配置：更新 MCP 配置文件，添加 Gumroad MCP Server 的配置项。
调试方式
- 验证 Node.js 安装：
bash node --version - 检查 Gumroad 访问令牌：确保
GUMROAD_ACCESS_TOKEN环境变量已正确设置。 - 测试 API 连接：使用 AI 客户端发送查询命令，如 "How many sales did I make last month?"。