MCP Cn Commerce logo

MCP Cn Commerce

by TonyWang-hub

Read-only MCP access to orders, products, inventory, after-sales, and advertising data across eight Chinese commerce platforms.

Install MCP Cn Commerce

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tonywang-hub-mcp-cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce"
      ],
      "env": {
        "OCEANENGINE_APP_KEY": "YOUR_VALUE_HERE",
        "OCEANENGINE_APP_SECRET": "YOUR_VALUE_HERE",
        "OCEANENGINE_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "DOUDIAN_APP_KEY": "YOUR_VALUE_HERE",
        "DOUDIAN_APP_SECRET": "YOUR_VALUE_HERE",
        "DOUDIAN_SHOP_ID": "YOUR_VALUE_HERE",
        "DOUDIAN_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "JD_APP_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx mcp-cn-commerce

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

TonyWang-hub/mcp-cn-commerce MCP server exposes merchant data from eight Chinese e-commerce and advertising platforms through standard MCP interfaces. It runs locally over stdio, with a separate server command for each platform and credentials supplied through environment variables. Reach for it when an agent needs to query orders, products, inventory, after-sales records, logistics, or advertising reports without performing write operations.

Use cases

  • Aggregate orders across multiple Chinese commerce platforms
  • Monitor low-stock products and inventory levels
  • Compare advertising spend and ROAS trends
  • Analyze refunds and after-sales patterns
  • Export operational records for reporting

Key features

  • Read-only merchant data access
  • Eight Chinese commerce and advertising platforms
  • Orders, products, refunds, inventory, and logistics data
  • Advertising reports for Ocean Engine and Qianchuan
  • Shared metrics, traces, alerts, and data export tools
  • Local stdio MCP entry points

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

96/96 checks healthy over the last 58d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · mcp-cn-commerce (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars92Stargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity17 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Cn Commerce works

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.

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.

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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Cn Commerce

Install the Python package from PyPI with `pip install mcp-cn-commerce`. The package contains separate MCP entry points for each supported platform.

Yes. The README provides Claude Desktop configuration using local commands such as `mcp-cn-oceanengine`, and states that the server uses standard stdio MCP.

Yes.

It supports Ocean Engine and Qianchuan advertising, Douyin Shop, JD.com, Taobao, Pinduoduo, Kuaishou, Xiaohongshu, and WeChat Store.

Credentials depend on the selected platform.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Cn Commerce AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tonywang-hub-mcp-cn-commerce?style=directory)](https://allmcps.com/mcp/tonywang-hub-mcp-cn-commerce)
HTML Embed
<a href="https://allmcps.com/mcp/tonywang-hub-mcp-cn-commerce"><img src="https://allmcps.com/api/badge/tonywang-hub-mcp-cn-commerce?style=directory" alt="MCP Cn Commerce on AllMCPs" /></a>