Woo MCP Server

🚀 [使用指南]

本項目提供了與 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: {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": "Premium T-Shirt",
        "type": "simple",
        "regular_price": "29.99",
        "description": "舒適的棉質 T 恤，多種尺碼可選。",
        "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"創建新的產品，ID: {result['id']}")

# 運行函數
asyncio.run(add_new_product())

📚 詳細文檔

📋 函數參數

所有函數都接受其特定的 API 動作參數，以及以下可選參數：

🔒 安全注意

⚠️ 重要提示

要訪問 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 文件。