🛒 WooCommerce MCP Server | Python Edition

🛒 WooCommerce MCP Server | Python Edition

פתרון פשוט ויעיל לחיבור חנויות WooCommerce עם Model Context Protocol

🇺🇸 English Version | 🇮🇱 גרסה עברית

📌 מה זה?

שרת Model Context Protocol (MCP) המאפשר אינטגרציה מלאה עם חנויות WooCommerce באמצעות ה-WordPress REST API. הספרייה מספקת כלים מקיפים לניהול כל היבטי המוצרים, הזמנות, לקוחות, משלוח, מיסים, הנחות וקונפיגורציית החנות.

🚀 התקנה מהירה

# שלב 1: שכפל את הרפוזיטורי
git clone https://github.com/yourusername/woocommerce-mcp-server.git
cd woocommerce-mcp-server

# שלב 2: התקן תלויות
pip install -r requirements.txt

# שלב 3: הגדר משתני סביבה (ראה הסבר בהמשך)

☁️ פריסה ב-Railway

השרת מוכן לפריסה מיידית בפלטפורמת Railway:

# שלב 1: שכפל את הרפוזיטורי לחשבון GitHub שלך

# שלב 2: היכנס ל-Railway והתחבר עם חשבון GitHub
# https://railway.app/

# שלב 3: לחץ על "New Project" ובחר "Deploy from GitHub repo"

# שלב 4: בחר את הרפוזיטורי המשוכפל

# שלב 5: הגדר את משתני הסביבה הבאים:
# - WORDPRESS_SITE_URL
# - WOOCOMMERCE_CONSUMER_KEY
# - WOOCOMMERCE_CONSUMER_SECRET
# - WORDPRESS_USERNAME (אופציונלי)
# - WORDPRESS_PASSWORD (אופציונלי)
# - MCP_HOST=0.0.0.0
# - MCP_PORT=8000

# שלב 6: המתן לסיום הבנייה והפריסה

יתרונות פריסה ב-Railway:

• 🔄 פריסה אוטומטית מ-GitHub
• 🔒 SSL אוטומטי
• 📊 ניטור ולוגים מובנים
• 🔍 דומיין חינמי מובנה (תת-דומיין של railway.app)
• ⚡ סקיילינג אוטומטי לפי הצורך

⚙️ קונפיגורציה

יש ליצור קובץ .env בתיקיית הבסיס של הפרויקט עם הפרטים הבאים:

WORDPRESS_SITE_URL=https://your-wordpress-site.com
WOOCOMMERCE_CONSUMER_KEY=your-woocommerce-consumer-key
WOOCOMMERCE_CONSUMER_SECRET=your-woocommerce-consumer-secret
WORDPRESS_USERNAME=your-wordpress-username
WORDPRESS_PASSWORD=your-wordpress-password

משתני סביבה

* נדרש רק עבור שיטות WordPress API

🔐 אפשרויות אימות

אימות WooCommerce

גישה ל-API של WooCommerce דורשת מפתחות צרכן שניתן ליצור בלוח הבקרה של WordPress תחת WooCommerce → הגדרות → מתקדם → REST API.

אימות WordPress

עבור שיטות ספציפיות ל-WordPress (כמו ניהול פוסטים), יש לספק:

• אישורי שם משתמש/סיסמה לאימות בסיסי
• ה-REST API של WordPress חייב להיות מופעל באתר שלך

🔄 שיטות API

השרת תומך בשיטות API של WordPress ו-WooCommerce. להלן רשימת השיטות הזמינות מקובצות לפי קטגוריה:

ניהול תוכן WordPress

שיטות אלה דורשות אישורי שם משתמש/סיסמה של WordPress והן עצמאיות מה-API של WooCommerce.

מוצרי WooCommerce

קטגוריות מוצרים

תגיות מוצרים

מאפייני מוצרים

וריאציות מוצרים

הערות הזמנה

החזרי הזמנות

לקוחות WooCommerce

משלוח

מיסים

הנחות/קופונים

שערי תשלום

レポート

設定

システムステータス

データ

💻 使用例

MCP サーバーの初期化

import os
from dotenv import load_dotenv
from woocommerce_mcp import initialize

# טעינת משתני סביבה מקובץ .env
load_dotenv()

# אתחול שרת MCP
mcp = initialize()

# הפעלת השרת
async def main():
    mcp.run()

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

商品取得の例

import asyncio
from woocommerce_mcp.products import get_products

async def list_products():
    # קבלת המוצרים האחרונים
    products = await get_products({
        "per_page": 20, 
        "page": 1,
        "status": "publish"
    })
    
    for product in products:
        print(f"מוצר: {product['name']}, מחיר: {product['price']}")

# הפעלת הפונקציה
asyncio.run(list_products())

商品作成の例

import asyncio
from woocommerce_mcp.products import create_product

async def add_new_product():
    product_data = {
        "name": "חולצת פרימיום",
        "type": "simple",
        "regular_price": "99.99",
        "description": "חולצת כותנה נוחה, זמינה במגוון מידות וצבעים.",
        "short_description": "חולצת פרימיום באיכות גבוהה.",
        "categories": [
            {
                "id": 19
            }
        ],
        "images": [
            {
                "src": "http://example.com/wp-content/uploads/2022/06/t-shirt.jpg"
            }
        ]
    }
    
    result = await create_product(product_data)
    print(f"נוצר מוצר חדש עם מזהה: {result['id']}")

# הפעלת הפונקציה
asyncio.run(add_new_product())

📋 関数のパラメーター

すべての関数は、API 操作に固有のパラメーターに加えて、次のオプションパラメーターを受け取ります。

• site_url：（環境変数で設定されている場合は省略可能）WordPress のサイト URL
• consumer_key：（環境変数で設定されている場合は省略可能）WooCommerce のコンシューマーキー
• consumer_secret：（環境変数で設定されている場合は省略可能）WooCommerce のコンシューマーシークレット
• WordPress のメソッドの場合：username と password（環境変数で設定されている場合は省略可能）

🔒 セキュリティに関する注意

WooCommerce REST API にアクセスするには、API キーを作成する必要があります。WordPress ダッシュボードの WooCommerce → 設定 → 高度な設定 → REST API から作成できます。

📦 システム要件

• Python 3.9 以降
• WooCommerce プラグインがインストールされた WordPress サイト
• WooCommerce REST API キー
• Python パッケージ：mcp-server、httpx、python-dotenv

📄 ライセンス

MIT License - 詳細については LICENSE ファイルを参照してください

🛒 WooCommerce MCP Server | Python Edition

WORDPRESS_SITE_URL=https://your-wordpress-site.com
WOOCOMMERCE_CONSUMER_KEY=your-woocommerce-consumer-key
WOOCOMMERCE_CONSUMER_SECRET=your-woocommerce-consumer-secret
WORDPRESS_USERNAME=your-wordpress-username
WORDPRESS_PASSWORD=your-wordpress-password