Which integrations are available for this server?

Enables the automated import of products from AliExpress URLs, allowing AI agents to clean titles and apply pricing rules before importing. Supports pushing imported products to Shopify stores, including capabilities for bulk editing variants, toggling visibility, and multi-store management. Supports pushing imported products to Wix stores, including capabilities for bulk editing variants, toggling visibility, and multi-store management.

DSers MCP Product — Automate Dropshipping AI tools/AliExpress to Shopify & Wix Import

Smithery npm MCP Registry

An open-source MCP server to automate DSers product import, bulk edit variants, and push to Shopify or Wix using AI.

English | 中文

English

DSers MCP Product is an open-source MCP (Model Context Protocol) server that lets AI Agents automate the entire DSers import workflow — from AliExpress / Alibaba / 1688 product URL to Shopify or Wix store listing. Bulk import, batch edit variants, clean AliExpress titles, apply pricing rules, and push to multiple stores — all with a single sentence to your AI agent.

The server is hosted on Vercel, published on Smithery, npm, and the official MCP Registry.

Documentation

Document	Description
ARCHITECTURE.md	Three-layer architecture, directory structure, data flow
USAGE.md	Installation, client config (Cursor, Claude Desktop), scenario examples
SKILL.md	AI agent instruction file — workflow, rules, push options, error handling
SKILL-CN.md	Chinese human-readable guide for SKILL.md

Install via npm

npx @lofder/dsers-mcp-product

Set environment variables DSERS_EMAIL and DSERS_PASSWORD before running, or add to your MCP client config:

{
  "mcpServers": {
    "dsers-mcp-product": {
      "command": "npx",
      "args": ["-y", "@lofder/dsers-mcp-product"],
      "env": {
        "DSERS_EMAIL": "your-email",
        "DSERS_PASSWORD": "your-password"
      }
    }
  }
}

Also listed on the official MCP Registry.

Install via Smithery

npx @smithery/cli mcp add @dsersx/product-mcp --client cursor

Or browse at smithery.ai/server/@dsersx/product-mcp.

Install from Source

# Clone
git clone https://github.com/lofder/dsers-mcp-product.git
cd dsers-mcp-product

# Install
npm install

# Configure (copy and fill in your DSers credentials)
cp .env.example .env

# Type check
npx tsc --noEmit

# Run with Smithery dev
npx @smithery/cli dev ./src/index.ts

Project Structure

dsers-mcp-product/
├── src/
│   ├── index.ts              # MCP server entry — tool registration
│   ├── service.ts            # Import flow orchestration (7 operations)
│   ├── provider.ts           # DSers API adapter
│   ├── rules.ts              # Rule validation & application engine
│   ├── push-options.ts       # Push option normalization
│   ├── resolver.ts           # URL normalization (AliExpress/Alibaba/1688)
│   ├── job-store.ts          # File-based job persistence
│   └── dsers/                # Low-level DSers API wrappers
│       ├── config.ts         # Configuration & environment
│       ├── auth.ts           # Login, session cache, auto-refresh
│       ├── client.ts         # Authenticated HTTP client
│       ├── account.ts        # Store & user management APIs
│       ├── product.ts        # Import list & push APIs
│       └── settings.ts       # Shipping, pricing, billing APIs
├── test/                     # Smoke tests
├── smithery.yaml             # Smithery runtime config
├── package.json
├── tsconfig.json
└── .env.example

Seven Tools

#	Tool	Title	Description
1	`dsers.store.discover`	DSers Store & Rule Discovery	Discover stores, shipping profiles, supported rules
2	`dsers.rules.validate`	Pricing & Content Rule Validator	Dry-run rule validation
3	`dsers.product.import`	AliExpress / Alibaba / 1688 Import	Import from URL(s), apply rules, get preview
4	`dsers.product.preview`	Import Draft Preview	Reload a saved preview
5	`dsers.product.visibility`	Shopify / Wix Visibility Toggle	Toggle draft / published
6	`dsers.store.push`	Push to Shopify / Wix Store	Push single/batch/multi-store
7	`dsers.job.status`	Job Status Tracker	Check push result

All tools include MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) and return structured error messages with {Error, Cause, Action} for AI agent consumption.

Three Prompts

Pre-built workflow templates that MCP clients can present to users:

Prompt	Description
`dsers.workflow.quick-import`	Import a single product and push to store as draft
`dsers.workflow.bulk-import`	Batch import with pricing multiplier
`dsers.workflow.multi-push`	Push one product to all connected stores

Credentials

The server supports two credential sources (checked in order):

HTTP headers x-dsers-email / x-dsers-password — used by Smithery and direct HTTP connections
Environment variables DSERS_EMAIL / DSERS_PASSWORD — used by local stdio (Cursor, Claude Desktop)

See USAGE.md for setup details per connection method.

Environment Variables

Variable	Required	Description
`DSERS_EMAIL`	Yes*	DSers account email (*or provide via HTTP header)
`DSERS_PASSWORD`	Yes*	DSers account password (*or provide via HTTP header)
`DSERS_ENV`	No	`production` (default) or `test`
`DSERS_BASE_URL`	No	Override API base URL
`IMPORT_MCP_STATE_DIR`	No	Job state directory (default: `.state`)

Also Available

A Python version is available for local stdio deployments.

License

MIT

中文

DSers MCP Product 是一个开源的 MCP (Model Context Protocol) 服务器，让 AI Agent 自动完成 DSers 的整个商品导入流程 —— 从速卖通 / Alibaba / 1688 商品链接到 Shopify 或 Wix 店铺上架。批量导入、批量编辑变体、清理速卖通标题、应用定价规则、推送到多个店铺 —— 只需一句话给你的 AI agent。

服务已托管在 Vercel，并发布到 Smithery、npm 和官方 MCP Registry。

文档

文档	说明
ARCHITECTURE.md	三层架构、目录结构、数据流
USAGE.md	安装、客户端配置（Cursor、Claude Desktop）、使用场景
SKILL.md	AI agent 指令文件 — 工作流、规则、推送选项、错误处理
SKILL-CN.md	SKILL.md 的中文说明

通过 npm 安装

npx @lofder/dsers-mcp-product

运行前设置环境变量 DSERS_EMAIL 和 DSERS_PASSWORD，或在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "dsers-mcp-product": {
      "command": "npx",
      "args": ["-y", "@lofder/dsers-mcp-product"],
      "env": {
        "DSERS_EMAIL": "your-email",
        "DSERS_PASSWORD": "your-password"
      }
    }
  }
}

同时已收录到官方 MCP Registry。

通过 Smithery 安装

npx @smithery/cli mcp add @dsersx/product-mcp --client cursor

或在 smithery.ai/server/@dsersx/product-mcp 浏览和安装。

从源码安装

# 克隆
git clone https://github.com/lofder/dsers-mcp-product.git
cd dsers-mcp-product

# 安装
npm install

# 配置（复制并填写你的 DSers 账户信息）
cp .env.example .env

# 类型检查
npx tsc --noEmit

# 开发运行
npx @smithery/cli dev ./src/index.ts

七个工具

#	工具	标题	说明
1	`dsers.store.discover`	店铺与规则发现	查询店铺、配送方案、支持的规则
2	`dsers.rules.validate`	定价与内容规则校验	规则校验试运行
3	`dsers.product.import`	速卖通/Alibaba/1688 导入	从 URL 导入、应用规则、获取预览
4	`dsers.product.preview`	导入草稿预览	重新加载已保存的预览
5	`dsers.product.visibility`	Shopify/Wix 可见性切换	切换草稿 / 上架
6	`dsers.store.push`	推送到 Shopify/Wix	单条/批量/多店铺推送
7	`dsers.job.status`	任务状态跟踪	查看推送结果

所有工具均包含 MCP 注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint），错误返回结构化格式 {Error, Cause, Action}，方便 AI agent 理解和处理。

三个预设提示

MCP 客户端可直接展示给用户的工作流模板：

提示	说明
`dsers.workflow.quick-import`	一键导入单个商品并推送为草稿
`dsers.workflow.bulk-import`	批量导入 + 统一定价倍率
`dsers.workflow.multi-push`	一个商品推送到所有店铺

其他版本

也提供 Python 版本，适用于本地 stdio 部署。

许可证

MIT

DSers MCP product