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 管理画面で、ダウンロード → 設定 → API に移動します
2. ユーザー用の新しい API キーを生成します
3. 公開鍵とトークンをコピーします
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 の顧客 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. リポジトリをフォークします
2. 機能ブランチを作成します
3. テストを含めて変更を加えます
4. プルリクエストを送信します

API リファレンス

このサーバーは EDD REST API をラップしています。エンドポイントの詳細については、公式ドキュメントを参照してください。

ライセンス

GPL-3.0 — 詳細については LICENSE を参照してください。

サポート

問題、質問、ご提案については、以下をご利用ください。

• GitHub で issue を作成する
• Very Good Plugins にお問い合わせください

---

🧡 Very Good Plugins が開発しました