# MCP CN Commerce

> Read-only access to orders and refunds on Douyin Shop, Taobao, JD and other Chinese stores, through each platform's official open API.

MCP CN Commerce is a community-built, read-only MCP server that lets your agent read a merchant's own business data from Chinese e-commerce platforms. Each platform runs as its own local connection and calls that platform's official open API with the app credentials and access token the merchant has been granted. It's an independent adapter, not made by any of the platforms.

What you can do with it
- Read Douyin Shop orders and refunds, as lists or one at a time
- Read Taobao orders, incremental order changes and refunds
- Read JD orders, order details and shop information
- Read orders and refunds on Kuaishou, Xiaohongshu and WeChat Store
- Check an Ocean Engine advertiser's account details and balance
- Export records to CSV or JSON, and build a daily order and refund report across shops that flags missing data

How it connects
It's a Python package (mcp-cn-commerce) that runs on your machine with uvx mcp-cn-commerce start followed by a platform: oceanengine, doudian, jd, taobao, pinduoduo, kuaishou, xiaohongshu or weixin_store. The install steps here start the Ocean Engine connection; change the last word to connect another platform, and add one connection per platform you use. Each needs that platform's own credentials as environment variables, such as DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_SHOP_ID and DOUDIAN_ACCESS_TOKEN for Douyin Shop, or JD_APP_KEY, JD_APP_SECRET and JD_ACCESS_TOKEN for JD. Calls go straight to the platforms' APIs, with no server of the maker's in between and no telemetry.

Good to know
- Every platform tool only reads; nothing in your shop is changed.
- Support varies by operation. Each tool's description says whether its official contract is documented and whether it's supported, and unsupported ones stop before calling the platform.
- The maker says no operation has been checked against a live merchant account yet, so compare the first results with your platform's back office.
- Pinduoduo reads are switched off until its full business schemas are available, and Ocean Engine reports aren't supported yet.
- Your app needs the matching permissions on each platform's open platform; the server only sees what your credentials allow.

- Type: Plugin
- Made by: tonywang-hub
- Category: E-commerce
- Formats: Local MCP
- Version: 0.1.6
- Source: https://github.com/tonywang-hub/mcp-cn-commerce
- Page: https://pluginboard.ai/plugins/mcp-cn-commerce

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `OCEANENGINE_ACCESS_TOKEN` (optional): Required when platform=oceanengine.
- `DOUDIAN_APP_KEY` (optional): Required when platform=doudian.
- `DOUDIAN_APP_SECRET` (optional): Required when platform=doudian.
- `DOUDIAN_SHOP_ID` (optional): Required when platform=doudian.
- `DOUDIAN_ACCESS_TOKEN` (optional): Required when platform=doudian.
- `JD_APP_KEY` (optional): Required when platform=jd.
- `JD_APP_SECRET` (optional): Required when platform=jd.
- `JD_ACCESS_TOKEN` (optional): Required when platform=jd.
- `TAOBAO_APP_KEY` (optional): Required when platform=taobao.
- `TAOBAO_APP_SECRET` (optional): Required when platform=taobao.
- `TAOBAO_ACCESS_TOKEN` (optional): Required when platform=taobao.
- `PINDUODUO_CLIENT_ID` (optional): Required when platform=pinduoduo.
- `PINDUODUO_CLIENT_SECRET` (optional): Required when platform=pinduoduo.
- `PINDUODUO_ACCESS_TOKEN` (optional): Required when platform=pinduoduo.
- `KUAISHOU_APP_KEY` (optional): Required when platform=kuaishou.
- `KUAISHOU_APP_SECRET` (optional): Required when platform=kuaishou.
- `KUAISHOU_SIGN_SECRET` (optional): Required when platform=kuaishou.
- `KUAISHOU_ACCESS_TOKEN` (optional): Required when platform=kuaishou.
- `XHS_CLIENT_ID` (optional): Required when platform=xiaohongshu.
- `XHS_CLIENT_SECRET` (optional): Required when platform=xiaohongshu.
- `XHS_ACCESS_TOKEN` (optional): Required when platform=xiaohongshu.
- `WX_APP_ID` (optional): Required with WX_APP_SECRET in managed token mode.
- `WX_APP_SECRET` (optional): Required with WX_APP_ID in managed token mode.
- `WX_ACCESS_TOKEN` (optional): Required in static token mode. Used by default when provided.
- `WX_TOKEN_MODE` (optional): static uses WX_ACCESS_TOKEN; managed obtains tokens with WX_APP_ID and WX_APP_SECRET.

Replace each `<NAME>` placeholder with your own value.

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "mcp-cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce==0.1.6",
        "start",
        "oceanengine"
      ]
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22mcp-cn-commerce%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-cn-commerce%3D%3D0.1.6%22%2C%22start%22%2C%22oceanengine%22%5D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"mcp-cn-commerce","command":"uvx","args":["mcp-cn-commerce==0.1.6","start","oceanengine"]}'
```

Copilot CLI:

```shell
copilot mcp add mcp-cn-commerce -- uvx mcp-cn-commerce==0.1.6 start oceanengine
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=mcp-cn-commerce&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJtY3AtY24tY29tbWVyY2U9PTAuMS42Iiwic3RhcnQiLCJvY2VhbmVuZ2luZSJdfQ%3D%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "mcp-cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce==0.1.6",
        "start",
        "oceanengine"
      ]
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add mcp-cn-commerce -- uvx mcp-cn-commerce==0.1.6 start oceanengine
```

### Codex

Run in your terminal:

```shell
codex mcp add mcp-cn-commerce -- uvx mcp-cn-commerce==0.1.6 start oceanengine
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "mcp-cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce==0.1.6",
        "start",
        "oceanengine"
      ]
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add mcp-cn-commerce uvx mcp-cn-commerce==0.1.6 start oceanengine
```

### OpenClaw

In a terminal: Run openclaw mcp add mcp-cn-commerce --command uvx, with --arg before each argument (mcp-cn-commerce==0.1.6 start oceanengine) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add mcp-cn-commerce -- uvx mcp-cn-commerce==0.1.6 start oceanengine
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "mcp-cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce==0.1.6",
        "start",
        "oceanengine"
      ]
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).
