Commerce-MCP

자연어로 커머스 운영을 지시하면 상품, 주문, 재고, CS, 콘텐츠, 광고, 브리핑까지 로컬에서 이어서 처리하는 AI 기반 Commerce MCP 서버다.

Commerce-MCP is a local-first AI commerce MCP server that turns natural-language instructions into product, order, inventory, CS, content, ad, and daily-briefing workflows.

Structure

입력부터 운영 브리핑까지 흐름을 로컬 수직 슬라이스로 묶었다.

The current implementation is a local-first vertical slice that stretches from product input to daily operations.

Seller Prompt
  -> commerce_parse_product
    -> StandardProduct
      -> Commerce Tools
        -> ChannelTransformer / Builtin Logic
          -> Mock Channel Adapters
            -> SQLite

What It Does

현재 저장소는 아래 15개 MCP 도구를 로컬 내장형으로 제공한다.

This repository currently exposes the following 15 MCP tools in a local-first builtin form.

Current Mode

현재 구현 범위는 아래와 같다.

The current implementation includes the following:

Quick Start

로컬에서 바로 실행하려면 아래 순서로 진행하면 된다.

Use the following steps to run the project locally.

python -m pip install -e .[dev]
pytest -q
python server.py

환경변수는 선택 사항이며 지정하지 않으면 프로젝트 루트의 commerce.db를 사용한다.

Environment variables are optional. If unset, the server uses commerce.db in the project root.

COMMERCE_MCP_DB_PATH=./commerce.db

Example Flow

보스가 실제로 쓰게 될 기본 흐름은 아래와 같다.

Here is the core operating flow the boss would actually use.

1. commerce_parse_product로 상품 입력 정규화

2. commerce_register_product로 채널 mock 등록

3. commerce_collect_orders로 주문 적재

4. commerce_process_orders로 송장 반영 및 재고 차감

5. commerce_manage_inventory와 commerce_generate_po로 부족 재고 점검

6. commerce_collect_cs와 commerce_respond_cs로 문의 대응

7. commerce_create_ad, commerce_report_ad, commerce_analytics, commerce_daily_briefing으로 운영 요약

Key Files

처음 들어왔을 때 보면 좋은 파일들이다.

These are the most useful entry points when you first open the project.

Notes

현재 채널 연동은 mock/builtin 중심이다. 실제 쿠팡/네이버/11번가 API를 붙일 때는 ModuleAdapter와 채널 어댑터를 교체하면 된다.

Current channel integrations are mock-first. When real Coupang, Naver, or 11st APIs are ready, replace the builtin adapter path behind ModuleAdapter.