Easy Digital Downloads

io.github.verygoodplugins由 GitHub 账号 verygoodplugins 发布v1.1.0更新于 Oct 24, 2026

MCP server for Easy Digital Downloads REST API - sales, customers, products, analytics

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

该 MCP 服务器将助手连接到 Easy Digital Downloads 商店的 REST API，用于查询销售、客户、产品、折扣和分析数据。

可以做什么
校验商店 API 地址与凭据，并检查与商店 REST API 的连通性（诊断）。列出并读取产品及其价格和统计信息，列出并读取销售记录，可按条件筛选或按购买密钥查询。列出并读取客户及其购买统计、终身价值和购买历史。获取收入与销售总额、指定日期范围的每日统计以及按产品划分的统计。列出并读取折扣码及使用统计，并获取文件下载日志。
适用场景
适合使用 Easy Digital Downloads 搭建 WordPress 商店、希望让助手直接回答收入、主要客户、产品销售表现、折扣码或下载活动等问题，而不必打开后台管理面板的场景。
运行要求
以 npm 包（Node.js）形式本地运行，或作为 Claude Desktop 扩展安装。需要一个启用了 REST API 的 EDD 商店，并设置三个环境变量：EDD_API_URL、EDD_API_KEY（公钥）和 EDD_API_TOKEN，可在 WordPress 后台的下载、设置、API 中生成。需要能访问该商店的网络。
安装前请注意
需要商店 API 凭据（EDD_API_KEY 和 EDD_API_TOKEN），可读取销售与客户数据；请勿将其写入共享配置或版本库。客户记录包含邮箱和购买历史，返回内容可能含个人数据。所列工具看起来是只读的，但仍建议使用专用的 API 用户并限制权限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Easy Digital Downloads，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-edd

MCP server for Easy Digital Downloads REST API - access sales data, customers, products, and analytics from your EDD store.

[npm version] [License: GPL-3.0]

Features

  • 📊 Sales Analytics - Revenue, transaction counts, date ranges
  • 👥 Customer Data - Purchase history, lifetime value
  • 🛍️ Product Catalog - Pricing tiers, licensing info
  • 🏷️ Discount Codes - Usage stats and configuration
  • 📥 Download Logs - File download tracking
  • 🔒 Type Safety - Full Zod schema validation

Installation

Quick Install (Claude Desktop)

Download the Desktop Extension for one-click installation:

Release page (download .mcpb asset)

Double-click the downloaded file to install. You'll be prompted for your API credentials.

npm Install

bash
npm install -g @verygoodplugins/mcp-edd

Or add to your Claude Desktop configuration directly (see below).

Configuration

Environment Variables

Set these environment variables before running the server:

bash
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"

Or create a .env file in your working directory.

Getting API Credentials

  1. In WordPress admin, go to Downloads → Settings → API
  2. Generate a new API key for your user
  3. Copy the Public Key and Token
  4. Your API URL is https://your-site.com/edd-api/

Claude Desktop Configuration

Add to your claude_desktop_config.json:

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"      }    }  }}

Available Tools

Setup / Diagnostics

ToolDescription
edd_validate_connectionValidate your Store API URL and credentials

Products

ToolDescription
edd_list_productsList all products with pricing and stats
edd_get_productGet detailed product info by ID

Sales

ToolDescription
edd_list_salesList recent sales with filters
edd_get_saleGet sale by ID or purchase key

Customers

ToolDescription
edd_list_customersList customers with purchase stats
edd_get_customerGet customer by ID or email

Note: edd_list_customers returns the EDD customer ID as id (usable with edd_get_customer(customerId=...)) and includes userId when available.

Statistics

ToolDescription
edd_get_statsGet earnings/sales totals
edd_get_stats_by_dateGet daily stats for date range
edd_get_stats_by_productGet stats breakdown by product

Discounts

ToolDescription
edd_list_discountsList all discount codes
edd_get_discountGet discount details by ID

Downloads

ToolDescription
edd_get_download_logsGet file download history

Example Usage

Once configured, you can ask Claude:

  • "Show me this month's sales revenue"
  • "List the top 10 customers by lifetime value"
  • "How many licenses were sold for WP Fusion last month?"
  • "Show me all active discount codes"
  • "Get the purchase history for [email protected]"

Development

bash
# Install dependenciesnpm install
# Buildnpm run build
# Run testsnpm test                    # Unit testsnpm run test:integration    # Integration tests (requires credentials)npm run test:all           # All tests
# Lintnpm run lint

Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes with tests
  4. Submit a pull request

API Reference

This server wraps the EDD REST API. See their documentation for detailed endpoint information.

License

GPL-3.0 - see LICENSE for details.

Support

For issues, questions, or suggestions:

Built with 🧡 by Very Good Plugins

来源：README.md，提交 058d5c6

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分