Magento 2 MCP 서버

이는 Magento 2 REST API에 연결되는 MCP(Model Context Protocol) 서버로, Claude와 다른 MCP 클라이언트가 Magento 스토어에서 제품 정보를 쿼리할 수 있도록 합니다.

특징

제품 특징

SKU 또는 ID로 제품 정보 조회
다양한 기준으로 상품을 검색하세요
제품 카테고리 가져오기
관련 상품 받기
제품 재고 정보를 얻으세요
제품 속성 가져오기
속성 코드와 값을 지정하여 제품 속성을 업데이트합니다.
필터링 및 정렬 기능을 갖춘 고급 제품 검색

고객 기능

고객의 이메일 주소로 주문한 모든 제품을 받아보세요

주문 및 수익 기능

특정 날짜 범위에 대한 주문 수 가져오기
특정 날짜 범위에 대한 수익 얻기
특정 날짜 범위에 대해 국가별로 필터링된 수익을 얻으세요
판매 수량 및 가장 많이 팔린 제품을 포함한 제품 판매 통계를 얻으세요
"오늘", "어제", "지난주", "이번 달", "YTD"와 같은 상대 날짜 표현식 지원
국가 코드와 국가 이름을 모두 사용한 국가 필터링 지원

필수 조건

Node.js(v14 이상)
REST API 액세스가 가능한 Magento 2 인스턴스
Magento 2 인스턴스에 대한 API 토큰

설치

이 저장소를 복제하세요
종속성 설치:

지엑스피1

용법

서버를 직접 실행

node mcp-server.js

테스트 클라이언트로 테스트하기

node test-mcp-server.js

Claude Desktop과 함께 사용

경로 노드를 확인하십시오 which node 와 함께
개발자 설정으로 이동하여 "구성 편집"을 클릭하세요. JSON 파일이 열립니다.
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"
      }
    }

1단계에서 확인한 경로로 /path/to/your/node 바꾸세요.
/path/to/mcp-server.js 이 저장소를 복제한 경로로 바꾸세요.
Magento 관리자의 시스템 > 통합에서 API 토큰을 얻을 수 있습니다.
Claude Desktop을 다시 시작합니다.
이제 Magento 스토어의 제품에 관해 Claude에게 질문할 수 있습니다.

사용 가능한 도구

서버는 다음 도구를 제공합니다.

제품 도구

get_product_by_sku : SKU별로 제품에 대한 자세한 정보를 가져옵니다.
search_products : Magento 검색 기준을 사용하여 제품 검색
get_product_categories : SKU별로 특정 제품의 카테고리를 가져옵니다.
get_related_products : SKU별로 특정 제품과 관련된 제품을 가져옵니다.
get_product_stock : SKU별로 제품의 재고 정보를 가져옵니다.
get_product_attributes : SKU별로 제품의 모든 속성을 가져옵니다.
get_product_by_id : ID로 제품에 대한 자세한 정보를 가져옵니다.
advanced_product_search : 고급 필터링 옵션을 사용하여 제품 검색
update_product_attribute : SKU별로 제품의 특정 속성을 업데이트합니다.

고객 도구

get_customer_ordered_products_by_email : 이메일 주소로 고객의 모든 주문 상품을 가져옵니다.

주문 및 수익 도구

get_order_count : 지정된 날짜 범위에 대한 주문 수를 가져옵니다.
get_revenue : 특정 날짜 범위에 대한 총 수익을 가져옵니다.
get_revenue_by_country : 지정된 날짜 범위에 대한 국가별 수익을 필터링하여 가져옵니다.
get_product_sales : 특정 날짜 범위 내에서 판매된 제품 수량에 대한 통계를 가져옵니다.

Claude에 대한 예제 쿼리

MCP 서버가 Claude Desktop에 연결되면 다음과 같은 질문을 할 수 있습니다.

제품 문의

"셔츠로 된 제품이 있나요?"
"SKU SKU-xxx가 있는 제품에 대해 알려주세요"
"제품 SKU-xxx은 어떤 카테고리에 속합니까?"
"SKU-SKU-xxx와 관련된 상품이 있나요?"
"제품 SKU-xxx의 재고 상태는 어떻습니까?"
"가격순으로 정렬된 모든 상품을 보여주세요"
"제품 SKU-xxx의 가격을 $49.99로 업데이트"
"ABC-123 제품에 대한 설명을 방수 기능으로 변경하세요."
"제품 XYZ-456의 상태를 '활성화'로 설정하세요"

고객 문의

"고객 john.doe@example.com은 어떤 제품을 주문했습니까?"
" jane.smith@example.com 이메일 주소를 사용하는 고객의 주문 내역과 제품을 보여주세요."

주문 및 수익 쿼리

"오늘은 주문이 몇 건이나 되나요?"
"지난주 주문량은 어땠어요?"
"어제 매출이 얼마나 났나요?"
"지난달 우리 회사의 총 수익은 얼마였나요?"
"올해 현재까지 네덜란드에서 얼마나 많은 수익을 냈나요?"
"지난주 독일에서의 매출은 얼마였나요?"
"이번 달 미국과 캐나다의 수익을 비교해 보세요"
"이번 달 완료된 주문의 평균 주문 가치는 얼마인가요?"
"지난달에 몇 개의 제품을 판매했나요?"
"올해 가장 많이 팔린 제품은 무엇인가요?"
"주문당 평균 제품 수는 얼마입니까?"
"지난 분기에 독일에서 XYZ-123 제품을 몇 개 판매했나요?"
"이번 달 미국에서 가장 많은 수익을 낸 제품은 무엇입니까?"

개발

SSL 인증서 확인

개발 목적으로 서버는 SSL 인증서 검증을 우회하도록 구성되어 있습니다. 프로덕션 환경에서는 적절한 SSL 인증서를 사용하고 callMagentoApi 함수에서 httpsAgent 구성을 제거해야 합니다.

새로운 도구 추가

새 도구를 추가하려면 기존 코드의 패턴을 따르세요. 각 도구는 다음과 같이 정의됩니다.

독특한 이름
설명
Zod를 사용한 검증을 통한 입력 매개변수
요청을 처리하고 응답을 반환하는 비동기 핸들러 함수

특허

아이에스씨

Magento 2 MCP Server

Integrations