Woo MCP Server

🛒 WooCommerce MCP服务器| Python版

*使用 Model Context Protocol 连接 WooCommerce 商店的简单高效解决方案*

🇺🇸 英文版 | 🇮🇱 中文版本

📌 那是什么？

模型上下文协议（MCP）服务器，可通过WordPress REST API与WooCommerce商店完全集成。该库提供了全面的工具来管理产品，订单，客户，运输，税收，折扣和商店配置的各个方面。

🚀 快速安装

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

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

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

☁️ 发布在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: המתן לסיום הבנייה והפריסה

铁路的优势：

• 🔄 自动从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 认证

访问WooCommerce API需要用户密钥，可以在WordPress控制面板下创建WooCommerce→设置→高级→REST API。

WordPress认证

对于特定于WordPress的方法（如帖子管理），您必须提供：

• 基本身份验证用户名/密码
• WordPress REST API 必须在您的网站上启用

🔄 API 方法

它支持WordPress和WooCommerce API。下面是按类别分类的可用方法列表：

WordPress内容管理

这些方法需要 WordPress 用户名/密码验证，并且独立于 WooCommerce API。

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网站地址
• consumer_key（如果在环境变量中设置，则可选） WooCommerce消费者密钥
• consumer_secret（如果在环境变量中设置，则可选） WooCommerce消费者秘密
• 对于WordPress方法： username 还有…password （如果在环境变量中设置，则可选）

🔒 安全说明

要访问WooCommerce REST API，您需要创建API密钥。它们可以在WordPress控制面板下创建 WooCommerce → 设置 → 高级 → REST API.

📦 系统要求

• Python 3.9 及以上
• WordPress网站安装WooCommerce插件
• WooCommerce 的 REST API
• Python 套件： mcp-server, httpx, python-dotenv

📄 许可证

MIT License - 查看 LICENSE 文件以了解更多详情

______________________________________________________________________

🛒 WooCommerce MCP服务器| Python版

*使用模型上下文协议连接WooCommerce商店的简单有效的解决方案*

🇮🇱 希伯来语版本 | 🇺🇸 英文版

📌 这是怎么一回事？

用于WooCommerce集成的模型上下文协议（MCP）服务器，与WordPress REST API兼容。该库提供了全面的工具，用于管理产品、订单、客户、运输、税务、折扣和商店配置的各个方面。

🚀 快速安装

# Step 1: Clone the repository
git clone https://github.com/yourusername/woocommerce-mcp-server.git
cd woocommerce-mcp-server

# Step 2: Install dependencies
pip install -r requirements.txt

# Step 3: Configure environment variables (see below)

☁️ 铁路部署

服务器已准备好立即部署到 铁路 平台：

# Step 1: Clone the repository to your GitHub account

# Step 2: Log in to Railway and connect with your GitHub account
# https://railway.app/

# Step 3: Click on "New Project" and select "Deploy from GitHub repo"

# Step 4: Select the cloned repository

# Step 5: Configure the following environment variables:
# - WORDPRESS_SITE_URL
# - WOOCOMMERCE_CONSUMER_KEY
# - WOOCOMMERCE_CONSUMER_SECRET
# - WORDPRESS_USERNAME (optional)
# - WORDPRESS_PASSWORD (optional)
# - MCP_HOST=0.0.0.0
# - MCP_PORT=8000

# Step 6: Wait for the build and deployment to complete

铁路部署的好处：

• 🔄 从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身份验证

WooCommerce API访问需要消费者密钥，您可以在WooCommCommerce下的WordPress仪表板中生成这些密钥→ 设置→ 高级→ REST API。

WordPress身份验证

对于WordPress特定的方法（如管理帖子），您需要提供：

• 用于基本身份验证的用户名/密码凭据
• 必须在您的网站上启用WordPress REST API

🔄 API方法

服务器同时支持WordPress和WooCommerce API方法。以下是按类别分组的可用方法列表：

WordPress内容管理

这些方法需要WordPress用户名/密码凭据，并且独立于WooCommerce API。

WooCommerce产品

产品分类

产品标签

产品属性

产品变化

产品评论

WooCommerce订单

订单备注

订单退款

WooCommerce客户

运输

税收

折扣/优惠券

支付网关

报告

设置

系统状态

数据

💻 使用示例

初始化MCP服务器

import os
from dotenv import load_dotenv
from woocommerce_mcp import initialize

# Load environment variables from .env
load_dotenv()

# Initialize the MCP server
mcp = initialize()

# Run the server
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():
    # Get latest products
    products = await get_products({
        "per_page": 20, 
        "page": 1,
        "status": "publish"
    })
    
    for product in products:
        print(f"Product: {product['name']}, Price: {product['price']}")

# Run the function
asyncio.run(list_products())

创建产品的示例

import asyncio
from woocommerce_mcp.products import create_product

async def add_new_product():
    product_data = {
        "name": "Premium T-Shirt",
        "type": "simple",
        "regular_price": "29.99",
        "description": "Comfortable cotton t-shirt, available in various sizes.",
        "short_description": "Premium quality t-shirt.",
        "categories": [
            {
                "id": 19
            }
        ],
        "images": [
            {
                "src": "http://example.com/wp-content/uploads/2022/06/t-shirt.jpg"
            }
        ]
    }
    
    result = await create_product(product_data)
    print(f"Created new product with ID: {result['id']}")

# Run the function
asyncio.run(add_new_product())

📋 功能参数

所有函数都接受API操作的特定参数，以及以下可选参数：

• site_url：（如果在env中设置，则可选）WordPress站点URL
• consumer_key：（如果在env中设置，则可选）WooCommerce消费者密钥
• consumer_secret：（如果在env中设置，则可选）WooCommerce消费者机密
• 对于WordPress方法： username 和 password （如果在env中设置，则可选）

🔒 安全说明

对于WooCommerce REST API访问，您需要生成API密钥。您可以在WooCommerce下的WordPress仪表板中创建它们→ 设置→ 高级→ REST API。

📦 系统要求

• Python 3.9或更高版本
• 安装了WooCommerce插件的WordPress网站
• WooCommerce REST API密钥
• Python包： mcp-server, httpx, python-dotenv

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件