Easy Digital Downloads

mcp-edd

适用于 Easy Digital Downloads REST API 的 MCP 服务——从你的 EDD 商店访问销售数据、客户、产品和分析数据。

功能

• 📊 销售分析 - 收入、交易数量、日期范围
• 👥 客户数据 - 购买记录、生命周期价值
• 🛍️ 产品目录 - 定价层级、许可信息
• 🏷️ 折扣码 - 使用统计和配置
• 📥 下载日志 - 文件下载跟踪
• 🔒 类型安全 - 完整的 Zod 模式验证

安装

快速安装（Claude Desktop）

下载桌面扩展，即可一键安装：

发布页面（下载 .mcpb 资源）

双击下载的文件即可安装。系统会提示你输入 API 凭据。

通过 npm 安装

npm install -g @verygoodplugins/mcp-edd

或者直接添加到 Claude Desktop 配置中（见下文）。

配置

环境变量

运行服务之前，请设置以下环境变量：

export EDD_API_URL="https://your-store.com/edd-api/"
export EDD_API_KEY="your-api-public-key"
export EDD_API_TOKEN="your-api-token"

或者在工作目录中创建 .env 文件。

获取 API 凭据

1. 在 WordPress 管理后台中，前往 Downloads → Settings → API
2. 为你的用户生成新的 API 密钥
3. 复制 Public Key 和 Token
4. 你的 API URL 为 https://your-site.com/edd-api/

Claude Desktop 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "edd": {
      "command": "npx",
      "args": ["-y", "@verygoodplugins/mcp-edd"],
      "env": {
        "EDD_API_URL": "https://your-store.com/edd-api/",
        "EDD_API_KEY": "your-api-public-key",
        "EDD_API_TOKEN": "your-api-token"
      }
    }
  }
}

可用工具

设置 / 诊断

工具	描述
edd_validate_connection	验证你的商店 API URL 和凭据

产品

工具	描述
edd_list_products	列出所有产品及其定价和统计信息
edd_get_product	根据 ID 获取产品详细信息

销售

工具	描述
edd_list_sales	根据筛选条件列出近期销售记录
edd_get_sale	根据 ID 或购买密钥获取销售记录

客户

工具	描述
edd_list_customers	列出客户及其购买统计信息
edd_get_customer	根据 ID 或电子邮件获取客户

注意：edd_list_customers 返回 EDD customer ID 作为 id（可用于 edd_get_customer(customerId=...)），并在可用时包含 userId。

统计信息

工具	描述
edd_get_stats	获取收入 / 销售总额
edd_get_stats_by_date	获取指定日期范围内的每日统计信息
edd_get_stats_by_product	按产品获取统计明细

折扣

工具	描述
edd_list_discounts	列出所有折扣码
edd_get_discount	根据 ID 获取折扣详情

下载

工具	描述
edd_get_download_logs	获取文件下载历史记录

使用示例

配置完成后，你可以向 Claude 提问：

• “显示本月的销售收入”
• “列出生命周期价值最高的 10 位客户”
• “上个月 WP Fusion 售出了多少个许可证？”
• “显示所有有效的折扣码”
• “获取 [email protected] 的购买记录”

开发

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test                    # Unit tests
npm run test:integration    # Integration tests (requires credentials)
npm run test:all           # All tests

# Lint
npm run lint

贡献

欢迎贡献！请：

1. Fork 此仓库
2. 创建功能分支
3. 编写测试并进行修改
4. 提交拉取请求

API 参考

此服务封装了 EDD REST API。有关端点的详细信息，请参阅其文档。

许可证

GPL-3.0 - 详情请参阅 LICENSE。

支持

如有问题、疑问或建议：

• 在 GitHub 上提交 issue
• 联系 Very Good Plugins

---

由 Very Good Plugins 倾情打造 🧡