Woocommerce MCP Server Rdn

🚀 WooCommerce MCP 服務器

WooCommerce MCP 服務器是一個強大的工具，它基於模型上下文協議（MCP），能將 WooCommerce 與 Claude 等 AI 助手集成，讓 AI 助手可以與 WooCommerce 店鋪進行交互，實現訂單數據的獲取等功能。

🚀 快速開始

此服務器提供工具，使 AI 助手能夠與 WooCommerce 店鋪交互，允許它們：

• 獲取最近訂單，帶有可選過濾
• 獲取特定訂單 ID 的詳細信息

✨ 主要特性

• 提供工具讓 AI 助手與 WooCommerce 店鋪交互。
• 支持獲取最近訂單，且可進行可選過濾。
• 能夠獲取特定訂單 ID 的詳細信息。

📦 安裝指南

先決條件

要使用此 MCP 服務器，您需要以下內容：

1. Node.js：確保安裝了 Node.js（建議版本 14 或更高）。
2. npm：驗證 npm 是否已安裝。
3. WooCommerce REST API 訪問權限：需要 WooCommerce 店鋪的管理員訪問權限以獲取 API 令牌。

安裝步驟

按照以下步驟安裝 MCP 服務器：

1. 克隆此倉庫：

   git clone [倉庫 URL]
   cdwoocommerce-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

🔧 技術細節

該服務器基於 Node.js 和 npm 構建，利用 WooCommerce REST API 實現與 WooCommerce 店鋪的交互。通過在 config.js 和 server.js 中進行配置，實現服務器的啟動和與 WooCommerce 的連接。同時，使用 @modelcontextprotocol/sdk 來構建 MCP 服務器和定義工具。

📄 許可證

MIT 許可證