Woocommerce MCP Server Rdn

🚀 WooCommerce MCP サーバー

このサーバーは、WooCommerce をClaudeやその他のAIアシスタントに統合するためのモデルコンテキストプロトコル (MCP) サーバーです。AIアシスタントがWooCommerceストアとやり取りできるようにすることで、特定のタスクを自動化し、ユーザーエクスペリエンスを向上させます。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントはWooCommerceストアとやり取りできます。具体的には、最近の注文を取得したり、特定の注文IDの詳細を取得したりすることができます。

✨ 主な機能

• 最近の注文を取得する機能（オプションでフィルタリング可能）
• 特定の注文IDの詳細情報を取得する機能

📦 インストール

前提条件

このMCPサーバーを使用するには、以下が必要です。

1. Node.js：Node.jsがインストールされていることを確認してください（推奨バージョンは14以上）。
2. npm：npmがインストールされていることを確認してください。
3. WooCommerce REST APIアクセス権：WooCommerceストアの管理者アクセス権が必要です。これにより、APIトークンを取得できます。

インストール手順

MCPサーバーをインストールするには、以下の手順に従ってください。

1. このリポジトリをクローンします。

   git clone [リポジトリURL]
   cd woocommerce-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. サーバーを起動します。

   npm start
   

📚 ドキュメント

設定

WooCommerce設定

config.js ファイルに以下の設定を追加してください。

const wooCommerceConfig = {
    URL: 'YOUR_WOOCOMMERCE_SITE_URL',
    CONSUMER_KEY: 'YOUR_API_KEY',
    CONSUMER_SECRET: 'YOUR_API_SECRET'
};

MCPサーバー設定

server.js ファイルで、WooCommerce設定を読み込み、MCPサーバーを初期化します。

const wooCommerce = require('woocommerce')(config);
const mcpServer = new McpServer(wooCommerce);
mcpServer.start();

サーバーの実行

サーバーを起動した後、以下のエンドポイントでMCPサービスにアクセスできます。

• 最近の注文を取得する：GET /api/orders
• 特定の注文を取得する：GET /api/orders/{orderId}

Claudeデスクトップとの統合

ClaudeデスクトップでこのMCPサーバーを使用するには、以下の手順に従ってください。

1. Claudeデスクトップ をダウンロードしてインストールします。
2. config.json ファイルにMCPサーバーの詳細を追加します。

   {
       "servers": [
           {
               "name": "WooCommerce MCP Server",
               "host": "localhost",
               "port": "3000"
           }
       ]
   }
   

3. Claudeデスクトップを起動し、WooCommerceストアと統合します。

利用可能なツール

基本的な使用法

// 最近の注文を取得するツール
server.tool(
    'getRecentOrders',
    {
        count: z.number().int().positive().describe('取得する注文の数（最大10件）')
    },
    async ({count}) => {
        const orders = await wooCommerce.orders.getAll({
            per_page: count,
            page: 1
        });
        
        return {
            content: [
                {
                    type: 'text',
                    text: JSON.stringify(orders.data, null, 2)
                }
            ]
        };
    }
);

// 特定の注文を取得するツール
server.tool(
    'getOrderById',
    {
        orderId: z.string().describe('取得する注文のID')
    },
    async ({orderId}) => {
        const order = await wooCommerce.orders.getOrder(orderId);
        
        return {
            content: [
                {
                    type: 'text',
                    text: JSON.stringify(order.data, null, 2)
                }
            ]
        };
    }
);

カスタムMCPサーバーの構築

ステップ1 - プロジェクトの初期化

新しいNode.jsプロジェクトを作成し、必要な依存関係をインストールします。

mkdir my-mcp-server
cd my-mcp-server
npm init
npm install @modelcontextprotocol/sdk

package.json ファイルを編集して、ESモジュールをサポートするようにします。

{
    "type": "module",
    "scripts": {
        "start": "node index.js"
    }
}

ステップ2 - ツールの定義

index.js ファイルでMCPツールを定義します。

const { McpServer } = require('@modelcontextprotocol/sdk');

// MCPサーバーのインスタンスを作成
const server = new McpServer();

// ツールを登録：文字列の長さを取得する
server.tool(
    'getStrLength',
    {
        input: z.string().describe('長さを計算する文字列')
    },
    async ({input}) => {
        return {
            content: [
                {
                    type: 'text',
                    text: `${input.length} 文字列の長さ`
                }
            ]
        };
    }
);

// サーバーを起動
server.start();

ステップ3 - ローカルでのテスト

以下のコマンドを実行して、MCPサーバーをテストします。

npm start

リソース

• モデルコンテキストプロトコルのドキュメント
• MCP JavaScript SDK
• WooCommerce REST APIのドキュメント

📄 ライセンス

MITライセンス