# mcp-cn-commerce

Read-only stdio MCP server suite connecting AI agents to merchant operational metrics across Chinese marketplaces like Doudian, Taobao, and JD.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 87
- Author: TonyWang-hub
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TonyWang-hub/mcp-cn-commerce
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-cn-commerce

## What it does

The suite provides tools to inspect store records across Chinese marketplaces such as Doudian, Taobao, and JD. All registered tools run strictly in read-only mode. The agent cannot modify listings or publish content. Its focus stays on data extraction.

Built on Python 3.11+, each service communicates over stdio. The core includes connection pooling and payload data masking. Timestamps follow uniform formatting rules. Pagination gaps get explicitly flagged in generated summaries.

Running the server requires API credentials and access tokens for each platform. Reading operations for Pinduoduo remain disabled because official data schemas were missing. Every platform adapter currently flags `live_verified: false`. Live merchant account reconciliation is still pending.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `OCEANENGINE_ACCESS_TOKEN`, `DOUDIAN_APP_KEY`, `DOUDIAN_APP_SECRET`, `DOUDIAN_SHOP_ID`, `DOUDIAN_ACCESS_TOKEN`, `JD_APP_KEY`, `JD_APP_SECRET`, `JD_ACCESS_TOKEN`, `TAOBAO_APP_KEY`, `TAOBAO_APP_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> --transport stdio mcp-cn-commerce -- uvx mcp-cn-commerce
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-cn-commerce <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-cn-commerce --env OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> --env DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> --env DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> --env DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> --env DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> -- uvx mcp-cn-commerce
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-cn-commerce <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-cn-commerce": {
            "command": "uvx",
            "args": [
                "mcp-cn-commerce"
            ],
            "env": {
                "OCEANENGINE_ACCESS_TOKEN": "<OCEANENGINE_ACCESS_TOKEN>",
                "DOUDIAN_APP_KEY": "<DOUDIAN_APP_KEY>",
                "DOUDIAN_APP_SECRET": "<DOUDIAN_APP_SECRET>",
                "DOUDIAN_SHOP_ID": "<DOUDIAN_SHOP_ID>",
                "DOUDIAN_ACCESS_TOKEN": "<DOUDIAN_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-cn-commerce <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-cn-commerce": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-cn-commerce"
            ],
            "env": {
                "OCEANENGINE_ACCESS_TOKEN": "<OCEANENGINE_ACCESS_TOKEN>",
                "DOUDIAN_APP_KEY": "<DOUDIAN_APP_KEY>",
                "DOUDIAN_APP_SECRET": "<DOUDIAN_APP_SECRET>",
                "DOUDIAN_SHOP_ID": "<DOUDIAN_SHOP_ID>",
                "DOUDIAN_ACCESS_TOKEN": "<DOUDIAN_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-cn-commerce <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OCEANENGINE_ACCESS_TOKEN=<OCEANENGINE_ACCESS_TOKEN> -e DOUDIAN_APP_KEY=<DOUDIAN_APP_KEY> -e DOUDIAN_APP_SECRET=<DOUDIAN_APP_SECRET> -e DOUDIAN_SHOP_ID=<DOUDIAN_SHOP_ID> -e DOUDIAN_ACCESS_TOKEN=<DOUDIAN_ACCESS_TOKEN> mcp-cn-commerce uvx mcp-cn-commerce
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-cn-commerce <command>

## When to use it
- inspect order lists and refund records from Doudian and JD
- retrieve advertiser account balances from Ocean Engine
- extract Taobao sales metrics without write access
- normalize store transaction amounts and dates across marketplaces

## Example prompts
- Check our current account balance in Ocean Engine.
- Fetch recent order details from our Doudian store.
- Summarize pending refund records across JD customer orders.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md