Woo MCP Server

🚀 クイックスタート

このドキュメントは、MCP サーバーの使用方法を説明しています。MCP サーバーを使用することで、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": "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 アクションパラメータと、以下のオプションパラメータを受け入れます。

• 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 ファイルを参照してください。