이 모델 Context Protocol (MCP) 서버는 Magento 2 REST API에 연결되며 Claude 및 기타 MCP 클라이언트가 Magento 저장소에서 제품 정보를 쿼리 할 수 있습니다.

특징

제품 특징

• SKU 또는 ID로 쿼리 제품 정보
• 다양한 기준을 활용한 제품 검색
• 제품 분류
• 관련 제품 얻기
• 제품 재고 정보 얻기
• 제품 속성 얻기
• 속성 코드 및 값을 지정하여 제품 속성 업데이트
• 고급 제품 검색 필터링 및 분류

고객 특징

• 이메일 주소로 고객에 대한 모든 주문 제품 얻기

순서와 수익 특징

• 특정한 날짜 범위를 위한 순서 조사를 얻으십시오
• 특정 날짜 범위에 대한 수익을 얻을
• 특정 날짜 범위에 대한 국가로 필터링 된 수익을 얻으십시오.
• 수량 판매 및 최고 판매 제품을 포함한 제품 판매 통계
• “today”, “yesterday”, “last week”, “this month”, "YTD"와 같은 상대 날짜 표현에 대한 지원
• 국가 코드와 국가 이름을 사용하여 필터링하는 국가 지원

필수품

• Node.js (v14 이상)
• REST API 액세스가있는 Magento 2 인스턴스
• Magento 2 인스턴스의 API 토큰

설치

1. 명세.

Magento 2 MCP Server

This is a Model Context Protocol (MCP) server that connects to a Magento 2 REST API, allowing Claude and other MCP clients to query product information from a Magento store.

Features

Product Features

• Query product information by SKU or ID
• Search for products using various criteria
• Get product categories
• Get related products
• Get product stock information
• Get product attributes
• Update product attributes by specifying attribute code and value
• Advanced product search with filtering and sorting

Customer Features

• Get all ordered products for a customer by email address

Order and Revenue Features

• Get order count for specific date ranges
• Get revenue for specific date ranges
• Get revenue filtered by country for specific date ranges
• Get product sales statistics including quantity sold and top-selling products
• Support for relative date expressions like “today”, “yesterday”, “last week”, “this month”, “YTD”
• Support for country filtering using both country codes and country names

Prerequisites

• Node.js (v14 or higher)
• A Magento 2 instance with REST API access
• API token for the Magento 2 instance

Installation

1. Clone this repository
2. Install dependencies:

npm install

Usage

Running the server directly

node mcp-server.js

Testing with the test client

node test-mcp-server.js

Using with Claude Desktop

1. Check your path node with which node
2. Go to the Developer settings and click “Edit config”. This will open a JSON file.
3. Add the following snippet within the mcpServers:

    "magento2": {
      "command": "/path/to/your/node",
      "args": ["/path/to/mcp-server.js"],
      "env": {
        "MAGENTO_BASE_URL": "https://YOUR_DOMAIN/rest/V1",
        "MAGENTO_API_TOKEN": "your-api-token"
      }
    }

3. Replace /path/to/your/node with the path you checked in step 1
4. Replace /path/to/mcp-server.js with the path where you cloned this repo
5. You can get an API token from System > Integrations in the Magento admin
6. Restart Claude Desktop.
7. You should now be able to ask Claude questions about products in your Magento store.

Available Tools

The server exposes the following tools:

Product Tools

• get_product_by_sku: Get detailed information about a product by its SKU
• search_products: Search for products using Magento search criteria
• get_product_categories: Get categories for a specific product by SKU
• get_related_products: Get products related to a specific product by SKU
• get_product_stock: Get stock information for a product by SKU
• get_product_attributes: Get all attributes for a product by SKU
• get_product_by_id: Get detailed information about a product by its ID
• advanced_product_search: Search for products with advanced filtering options
• update_product_attribute: Update a specific attribute of a product by SKU

Customer Tools