`medusa-mcp`

개요

medusa-mcp 는 Medusa JavaScript SDK와 통합되도록 설계된 모델 컨텍스트 프로토콜(MCP) 서버 입니다. Medusa 데이터 모델을 관리하고 상호 작용할 수 있는 확장 가능한 백엔드 계층을 제공하여 자동화, 오케스트레이션 및 지능형 서비스 확장을 지원합니다.

🧩 MCP 서버란 무엇인가요?

MCP 서버는 다음과 같은 특징을 갖춘 모듈식 확장 가능 백엔드입니다.

실시간 서비스 오케스트레이션을 지원합니다.
표준화된 고처리량 통신 지원
AI/자동화 도구와 실제 시스템 간의 브리지 역할을 합니다.

이러한 서버는 AI, IoT, 엔터프라이즈 소프트웨어 분야에서 JSON-RPC와 같은 표준화된 프로토콜을 사용하여 다양한 서비스를 연결하고 작업을 자동화하는 데 사용됩니다.

🔑 주요 특징

모듈형 아키텍처 - 유연성을 위한 구성 가능한 서비스
고효율성 – 속도와 규모에 최적화됨
확장 가능한 디자인 – 새로운 기능을 쉽게 추가하세요
교차 환경 배포 - 클라우드, 온프레미스 또는 하이브리드
AI 지원 인터페이스 - LLM 및 도구를 원활하게 통합

🧠 AI 시스템의 역할

MCP 서버를 사용하면 AI 에이전트는 다음을 수행할 수 있습니다.

API, 파일 또는 데이터베이스에서 실시간 데이터에 액세스
비즈니스 프로세스 자동화(예: 주문 이행, 가격 업데이트)
안전하고 통제된 방식으로 외부 서비스와 상호 작용합니다.

🚀 메두사 JS + MCP

medusa-mcp 사용하면 Medusa JS에서 다음을 수행할 수 있습니다.

워크플로 자동화(예: 재고 또는 가격 조정)
외부 도구(이메일, 분석 등)와 연결합니다.
AI 에이전트를 사용하여 추세를 분석하고 작업을 트리거합니다.
상거래 플랫폼을 위한 확장 가능한 모듈형 아키텍처 활성화

✨ 특징

✅ 모델 컨텍스트 프로토콜(MCP) 지원
📈 확장 가능한 인프라
🧱 확장 가능한 플러그인 아키텍처
🔗 Medusa JS SDK와 통합됨

🛠️ 설치

저장소를 복제하고 종속성을 설치합니다.

지엑스피1

프로젝트를 빌드하세요:

npm run build

▶️ 사용법

서버를 시작합니다:

npm start

MCP Inspector를 사용하여 테스트:

npx @modelcontextprotocol/inspector ./dist/index.js

참고: 다시 빌드한 후에는 Inspector와 브라우저를 다시 시작하세요.

🌍 환경 변수

변하기 쉬운	설명
`MEDUSA_BACKEND_URL`	Medusa 백엔드 URL
`PUBLISHABLE_KEY`	Medusa 게시 가능 API 키
`MEDUSA_USERNAME`	Medusa 관리자 사용자 이름(관리자용)
`MEDUSA_PASSWORD`	Medusa 관리자 비밀번호(관리자용)

서버는 http://localhost:3000 에서 실행됩니다.

🧠 아키텍처 다이어그램

Medusa JS와 외부 시스템을 갖춘 일반적인 설정에서 medusa-mcp 서버가 어떻게 적용되는지는 다음과 같습니다.

       +-------------------------+
       |     AI Assistant /      |
       |     LLM / Automation    |
       +-----------+-------------+
                   |
                   v
    +--------------+--------------+
    |     MCP Server (medusa-mcp) |
    |-----------------------------|
    | - JSON-RPC Communication    |
    | - AI-Ready Interface        |
    | - Plugin Support            |
    +------+----------------------+
                   |                             
                   +
                   |                                                         
                   v                                                         
         +-------------------+
         | Medusa Backend    |
         | (Products, Orders)|
         +-------------------+
                   |
                   |
                   v
           +--------------+
           | Medusa Store |
           | Frontend     |
           +--------------+
                   |
                   |
                   v
      +-------------------------+
      | External Services / API |
      | (e.g., Payments, Email) |
      +-------------------------+

🧪 사용자 정의

서버를 Medusa 설정에 맞게 조정하려면 다음을 수행합니다.

더욱 세부적인 제어를 위해 admin.json 과 store.json 사용자 고유의 OAS 정의로 바꾸세요.

oas/ 폴더의 OpenAPI 스키마를 다음과 같이 바꾸세요.
- admin.json – 관리자 엔드포인트
- store.json – 스토어프런트 엔드포인트

@medusajs/medusa-oas-cli 사용하여 이러한 파일을 다시 생성합니다.

이 프로젝트를 포크하여 사용자 정의 MCP 기반 Medusa 통합을 구축할 수도 있습니다.

🤝 기여하기

기여를 환영합니다! CONTRIBUTING.md 가이드를 참조하세요.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

Medusa MCP Server

Integrations