Siddhantbajaj Shopify MCP Server

🚀 Shopify MCP 服務器

Shopify MCP 服務器是一個模型上下文協議（MCP）服務器，它能將客戶端（如Claude）與您的Shopify商店數據連接起來。此服務器提供了一系列工具，可用於從您的Shopify商店獲取產品和客戶信息，為您的業務數據管理提供便利。

🚀 快速開始

先決條件

• Python 3.12 或更高版本
• 具有API訪問權限的Shopify商店
• Shopify API憑證（API密鑰、密碼和訪問令牌）

安裝

1. 克隆倉庫：

git clone https://github.com/siddhantbajaj/shopify-mcp-server.git
cd shopify-mcp-server

2. 創建並激活虛擬環境使用uv：

uv venv
source .venv/bin/activate  # 在Unix/MacOS上
# 或者
.venv\Scripts\activate  # 在Windows上

3. 安裝包：

uv pip install -e .

配置

1. 在根目錄中創建一個.env文件，並添加您的Shopify憑證：

SHOPIFY_SHOP_URL="your-store.myshopify.com"
SHOPIFY_API_KEY="your_api_key"
SHOPIFY_PASSWORD="your_api_password"
SHOPIFY_ACCESS_TOKEN="your_access_token"

將佔位符值替換為您的實際Shopify API憑證。

使用方法

1. 啟動MCP服務器：

python -m shopify_mcp_server.server

2. 該服務器公開了兩個工具：

get-product-list

從您的Shopify商店中檢索產品列表。

• 可選參數：limit（默認值為10）- 返回的產品最大數量

get-customer-list

從您的Shopify商店中檢索客戶列表。

• 可選參數：limit（默認值為10）- 返回的客戶最大數量

✨ 主要特性

• get-product-list：從您的Shopify商店中檢索產品列表
• get-customer-list：從您的Shopify商店中檢索客戶列表
• 更多功能即將到來

💻 使用示例

工具響應格式

產品

商品 (顯示 X):

標題: 商品名稱
ID: 123456789
類型: 類型
供應商: 供應商名稱
狀態: active
價格: $XX.XX
---

客戶

客戶 (顯示 X):

姓名: 約翰·多伊
ID: 123456789
電子郵件: john@example.com
訂單數: X
總消費金額: $XX.XX
---

🔧 技術細節

該項目使用：

• MCP（模型上下文協議） 用於構建AI驅動的工具
• Shopify Python API 用於Shopify集成
• UV 用於依賴管理

⚠️ 安全提示

⚠️ 重要提示

• 永遠不要將.env文件提交到版本控制中
• 保持您的Shopify API憑證安全
• 使用環境變量來存儲敏感信息

📄 許可證

該項目在MIT許可證下發布 - 有關詳細信息，請參閱LICENSE文件。

🤝 貢獻

1. 分叉倉庫
2. 創建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加一些很棒的功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打開Pull Request