mcp-cn-commerce — Chinese E-Commerce Platform MCP Servers

🛒 Let AI agents read Chinese e-commerce merchant business data. Not content publishing — business operations MCP connectors for AI agents like Claude, ChatGPT, Gemini.

Keywords: MCP Server, Model Context Protocol, Chinese e-commerce, AI agent, e-commerce data, 电商 MCP, 抖店, 京东, 巨量引擎, Ocean Engine, Douyin Shop, JD.com, Taobao, Pinduoduo, Python MCP, AI business intelligence, agent tool

English | 简体中文

Table of Contents

• What is mcp-cn-commerce?

• Why This Project

• Supported Platforms

• Quick Start

• Architecture

• Tools Reference

• Security

• FAQ

• Contributing

• Roadmap

What is mcp-cn-commerce?

A monorepo of independent MCP (Model Context Protocol) servers that give AI agents structured, type-safe access to Chinese e-commerce platform business data. Each server wraps one platform's open API:

• 巨量引擎 (Ocean Engine) — advertising campaign, report, and account data

• 抖店 (Douyin Shop) — orders, products, refunds, shop management

• 京东 (JD.com) — orders, products, shop information

• More coming: 淘宝, 拼多多, 快手, 小红书, 微信小店

All tools are read-only by default — AI agents can analyze your business data but cannot modify anything.

Why This Project

Existing Chinese-platform MCP servers all focus on content publishing (posting videos, searching trends). Zero cover merchant business operations — pulling ad reports, checking orders, managing refunds.

This is the first open-source MCP server suite for Chinese e-commerce business operations.

Platforms

Phase 4 (exploratory): 闲鱼 (Xianyu), 美团 (Meituan), 饿了么 (Ele.me) — restricted APIs, awaiting policy clarity.

358 tests across all 8 servers. CI runs on Python 3.11, 3.12, 3.13.

Quick Start

Installation

# Install a specific platform server
pip install mcp-cn-commerce[oceanengine]   # 巨量引擎 advertising
pip install mcp-cn-commerce[doudian]        # 抖店 Douyin Shop
pip install mcp-cn-commerce[jd]              # 京东 JD.com

# Or install all Phase 1 servers at once
pip install mcp-cn-commerce[all]

Configuration

Set credentials via environment variables:

# 巨量引擎 (Ocean Engine) — Advertising platform
export OCEANENGINE_APP_KEY="your_app_key"
export OCEANENGINE_APP_SECRET="your_app_secret"
export OCEANENGINE_ACCESS_TOKEN="your_access_token"

# 抖店 (Douyin Shop) — TikTok Shop China
export DOUDIAN_APP_KEY="your_app_key"
export DOUDIAN_APP_SECRET="your_app_secret"
export DOUDIAN_SHOP_ID="your_shop_id"
export DOUDIAN_ACCESS_TOKEN="your_access_token"

# 京东 (JD.com) — Jingdong e-commerce
export JD_APP_KEY="your_app_key"
export JD_APP_SECRET="your_app_secret"
export JD_ACCESS_TOKEN="your_access_token"

Add to Your MCP Client

Works with Claude Desktop, Cherry Studio, Kimi Work, and any MCP-compatible AI client:

{
  "mcpServers": {
    "oceanengine": {
      "command": "mcp-cn-oceanengine"
    },
    "doudian": {
      "command": "mcp-cn-doudian"
    },
    "jd": {
      "command": "mcp-cn-jd"
    }
  }
}

Example: AI Agent Querying Your Business

Once connected, you can ask your AI agent questions like:

"Show me this week's Ocean Engine campaign ROAS, sorted by spend" "Which Douyin Shop products are low on stock?" "How many JD refunds are pending approval?" "Compare my ad performance across Ocean Engine campaigns this month vs last month"

Architecture

mcp-cn-commerce/
├── .github/workflows/test.yml       # CI: pytest on push (3.11/3.12/3.13)
├── shared/                           # Shared auth/signing/pagination
│   └── cn_commerce_base.py           # CommerceMCPBase — extend for new platforms
├── servers/
│   ├── oceanengine/  17 tools        ├── doudian/    20 tools
│   ├── jd/           14 tools        ├── taobao/     13 tools
│   ├── pinduoduo/    13 tools        ├── kuaishou/   12 tools
│   ├── xiaohongshu/  12 tools        └── weixin-store/ 11 tools
├── docs/platforms.md                 # 8-platform API comparison & auth matrix
├── README.md / README_zh.md          # English / 简体中文
└── LICENSE                           # MIT

Each servers/<platform>/ is an independent MCP server. Users install only what they need.

Tools Summary

For full tool details, see the source code in each servers/<platform>/src/ directory. | get_product_list | Product catalog with pricing and stock | /product/list | | get_shop_info | Merchant shop information | /shop/info |

Security

This project handles sensitive e-commerce API credentials. Our security guarantees:

• 🔒 Runs locally — API keys and secrets never leave your machine

• 📖 Open source — every line of code is auditable

• 👁️ Read-only by default — all 14 tools only read data; zero write/modify/delete operations

• 📡 No telemetry — no usage data is collected, tracked, or transmitted

• 🖥️ Direct API calls — connects directly to platform APIs; no intermediate server or proxy

• 🔑 Env-var config — credentials are loaded from environment variables, never hardcoded

Roadmap

Phase 1 — Foundation ✅ (current)

• 巨量引擎: Ad campaign & report read APIs

• 巨量千川: E-commerce advertising (shared Ocean Engine auth)

• 抖店: Order, product, after-sale read APIs

• 京东: Order, product, shop read APIs

Phase 2 — Mid-Tier Expansion ⬜

• 淘宝 (Taobao): Full Top API integration — orders, products, logistics

• 拼多多 (Pinduoduo): Orders, products, promotion tools

Phase 3 — Long-Tail Coverage ⬜

• 快手 (Kuaishou): Orders, products, logistics

• 小红书 (Xiaohongshu): Orders, products, inventory

• 微信小店 (WeChat Store): Orders, products, after-sale

Phase 4 — Exploratory ⬜

• 闲鱼, 美团, 饿了么 (API access pending policy)

Related Resources

• Model Context Protocol (MCP) Documentation

• MCP Python SDK

• Claude Desktop — MCP Support

• Cherry Studio — Multi-Model MCP Client

• Platform API Comparison

Citation

If you use mcp-cn-commerce in your research or project:

@software{mcp-cn-commerce,
  author = {Wang, Zhuo},
  title = {mcp-cn-commerce: MCP Servers for Chinese E-Commerce Platforms},
  year = {2025},
  url = {https://github.com/TonyWang-hub/mcp-cn-commerce}
}

Star History

License

MIT — see LICENSE.