🛒 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 文件

🛒 WooCommerce MCP 服务 | Python 版

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