# TonyWang-hub/mcp-cn-commerce [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/TonyWang-hub/mcp-cn-commerce  
**GitHub Stars:** 52  
**Views:** 8  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/tonywang-hub-mcp-cn-commerce

## Description
Read-only merchant data connector for 8 Chinese e-commerce platforms — Tmall/Taobao, JD.com, Pinduoduo, Douyin Shop + Qianchuan ads, Kuaishou, Xiaohongshu, and WeChat Store. Orders, products, after-sales, inventory, and ad reports for AI agents. Published on the official MCP Registry. Install via pip install mcp-cn-commerce.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-cn-commerce": {
    "command": "uvx",
    "args": ["mcp-cn-commerce"],
    "env": {
      "OCEANENGINE_APP_KEY": "",
      "OCEANENGINE_APP_SECRET": "",
      "OCEANENGINE_ACCESS_TOKEN": "",
      "DOUDIAN_APP_KEY": "",
      "DOUDIAN_APP_SECRET": "",
      "DOUDIAN_SHOP_ID": "",
      "DOUDIAN_ACCESS_TOKEN": "",
      "JD_APP_KEY": ""
    }
  }
}
```

**Requires environment variables:** `OCEANENGINE_APP_KEY`, `OCEANENGINE_APP_SECRET`, `OCEANENGINE_ACCESS_TOKEN`, `DOUDIAN_APP_KEY`, `DOUDIAN_APP_SECRET`, `DOUDIAN_SHOP_ID`, `DOUDIAN_ACCESS_TOKEN`, `JD_APP_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What TonyWang-hub/mcp-cn-commerce MCP server does

TonyWang-hub/mcp-cn-commerce MCP server is a Python monorepo containing independent MCP servers for Chinese commerce platforms. The supported services are Ocean Engine and Qianchuan, Douyin Shop, JD.com, Taobao, Pinduoduo, Kuaishou, Xiaohongshu, and WeChat Store.

The connector focuses on merchant operations data rather than content publishing. Depending on the platform, agents can inspect orders, products, after-sales cases, refunds, logistics, reviews, inventory, store information, marketing data, and advertising performance. Ocean Engine and Qianchuan provide advertising-oriented data such as campaigns, reports, and account balances.

All exposed business tools are described as read-only. An agent can analyze retrieved records, but the server is not intended to change products, orders, campaigns, or other platform data.

## How it works

TonyWang-hub/mcp-cn-commerce MCP server uses the Model Context Protocol over local stdio. The package includes separate entry points, including `mcp-cn-oceanengine`, `mcp-cn-doudian`, `mcp-cn-jd`, `mcp-cn-taobao`, `mcp-cn-pinduoduo`, `mcp-cn-kuaishou`, `mcp-cn-xiaohongshu`, and `mcp-cn-weixin-store`.

Install the package once, then configure only the platform servers an agent needs. Each platform exposes its own collection of tools. The repository lists 147 tools in total across the eight platform servers, including platform-specific operations and four shared operational tools: metrics, request traces, alerts, and CSV or JSON export. Request metrics and tracing are collected during calls.

## Setup and configuration

The project targets Python 3.11 or newer and can be installed from PyPI with `pip install mcp-cn-commerce`. Credentials may be exported in the shell or placed in an MCP client’s environment configuration.

The README documents App Key, App Secret, and Access Token settings for Ocean Engine. Douyin Shop additionally uses a shop ID. JD.com uses App Key, App Secret, and Access Token. Other platform credentials are referenced through the repository’s platform-specific configuration documentation and server implementations.

MCP clients configure each selected entry point as a local command. The README provides examples for Claude Desktop, Cline, Cherry Studio, Continue, Kimi Work, Claude Code, Codex, OpenCode, and MiMo Code.

## Tools and capabilities

Platform coverage includes:

- Advertising plans, reports, account balances, and related advertising data for Ocean Engine and Qianchuan.
- Orders, products, after-sales, refunds, logistics, reviews, store data, and inventory-related information for supported commerce platforms.
- Shared metrics, traces, alert evaluation, and data export functions on each server.
- Workflow templates for reporting, negative-review alerts, customer-service classification, product selection, and KOL matching using simulated data without API credentials.

The repository reports automated tests across Python 3.11, 3.12, and 3.13, with 358 tests covering the listed platforms.

## Limitations and notes

TonyWang-hub/mcp-cn-commerce MCP server requires credentials issued by the relevant commerce or advertising platforms for live data access. The available data and operations differ by platform, so a client should select the corresponding entry point rather than expect one universal tool set.

The project does not publish content and does not provide write operations according to the README. Xianyu, Meituan, and Ele.me are listed as future possibilities because their APIs are currently restricted or dependent on policy changes. The included workflow templates can be tried without credentials, but they use simulated data rather than live merchant accounts.

_Full upstream README: https://allmcps.com/mcp/tonywang-hub-mcp-cn-commerce/readme_