Shopify Python MCP Server

Shopify API와 연동하는 MCP 서버입니다. 이 서버를 사용하면 Claude Desktop에서 Shopify의 제품 정보를 가져오고 조작할 수 있습니다.

기능

도구

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

1. list_products : 상품 일람 얻기

   • limit : 취득하는 상품수(최대 250, 디폴트치는 50)

2. get_product : 상품 상세 정보 얻기

   • product_id : 상품 ID(필수)

3. create_product : 새 제품 만들기

   • title : 상품명(필수)

   • body_html : 상품 설명(HTML 형식)

   • vendor : 벤더 이름

   • product_type : 상품 유형

   • tags : 태그 (쉼표로 구분)

   • status : 상태(active/draft/archived)

   • variants : 변형

   • options : 옵션

   • images : 이미지

4. update_product : 제품 업데이트

   • product_id : 상품 ID(필수)

   • title : 상품명

   • body_html : 상품 설명(HTML 형식)

   • vendor : 벤더 이름

   • product_type : 상품 유형

   • tags : 태그 (쉼표로 구분)

   • status : 상태(active/draft/archived)

   • variants : 변형

   • options : 옵션

   • images : 이미지

5. delete_product : 상품 삭제

   • product_id : 상품 ID(필수)

Related MCP server: Salesforce MCP Server

설정

필요한 환경 변수

이 서버를 사용하려면 다음 환경 변수를 설정해야 합니다.

• SHOPIFY_SHOP_URL : Shopify 스토어 URL(예: mystore.myshopify.com)

• SHOPIFY_API_KEY : Shopify Admin API의 API 키

• SHOPIFY_API_PASSWORD : Shopify Admin API의 API 비밀번호 (보안)

• SHOPIFY_API_VERSION : Shopify API 버전(기본값: 2023-10)

Claude Desktop에서 설정

Claude Desktop에서 사용하는 경우 다음 설정을 claude_desktop_config.json에 추가합니다.

macOS

설정 파일 위치: ~/Library/Application Support/Claude/claude_desktop_config.json

"mcpServers": {
  "shopify-py-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/your_path/shopify-py-mcp",
      "run",
      "shopify-py-mcp"
    ],
    "env": {
      "SHOPIFY_SHOP_URL": "your-store.myshopify.com",
      "SHOPIFY_API_KEY": "your-api-key",
      "SHOPIFY_API_PASSWORD": "your-api-password",
      "SHOPIFY_API_VERSION": "2023-10"
    }
  }
}

사용방법

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 도구를 호출합니다.

상품 일람 취득

商品一覧を取得してください。

상품 상세 정보 얻기

商品ID 1234567890の詳細情報を取得してください。

새로운 상품 만들기

以下の情報で新しい商品を作成してください：
- 商品名: サンプル商品
- 説明: これはサンプル商品です。
- 価格: 1000円

상품 업데이트

商品ID 1234567890を以下の情報で更新してください：
- 商品名: 更新後の商品名
- 価格: 2000円

상품 삭제

商品ID 1234567890を削除してください。

개발

종속성 설치

cd shopify-py-mcp
uv sync --dev --all-extras

디버깅

MCP Inspector를 사용하여 디버깅할 수 있습니다.

npx @modelcontextprotocol/inspector uv --directory /your_path/shopify-py-mcp run shopify-py-mcp

빌드 및 공개

패키지를 배포용으로 준비하려면:

1. 종속성을 동기화하여 잠금 파일 업데이트:

uv sync

2. 패키지 빌드:

uv build

3. PyPI에 게시:

uv publish

참고 : PyPI 자격 증명은 환경 변수 또는 명령 플래그로 설정해야합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN

• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD