🚀 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": ""
}
}
}
}
要是您用的是自托管的 Gumroad 实例，可以通过 GUMROAD_BASE_URL 来配置自定义地址：
{
"mcpServers": {
"gumroad": {
"command": "npx",
"args": ["-y", "gumroad-mcp@latest"],
"env": {
"GUMROAD_ACCESS_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 文件。