CN Commerce MCP Server

by tonywang-hubio.github.TonyWang-hub/mcp-cn-commercev0.1.5

Read-only merchant data from Tmall/Taobao, JD.com, Pinduoduo, Douyin, Kuaishou, Xiaohongshu and WeChat Store: orders, products, inventory and ad reports.

76Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install CN Commerce MCP server

claude mcp add cn-commerce -e OCEANENGINE_APP_KEY='<oceanengine-app-key>' -e OCEANENGINE_APP_SECRET='<oceanengine-app-secret>' -e OCEANENGINE_ACCESS_TOKEN='<oceanengine-access-token>' -e DOUDIAN_APP_KEY='<doudian-app-key>' -e DOUDIAN_APP_SECRET='<doudian-app-secret>' -e DOUDIAN_ACCESS_TOKEN='<doudian-access-token>' -e JD_APP_KEY='<jd-app-key>' -e JD_APP_SECRET='<jd-app-secret>' -e JD_ACCESS_TOKEN='<jd-access-token>' -- uvx mcp-cn-commerce

{
  "mcpServers": {
    "cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce"
      ],
      "env": {
        "OCEANENGINE_APP_KEY": "<oceanengine-app-key>",
        "OCEANENGINE_APP_SECRET": "<oceanengine-app-secret>",
        "OCEANENGINE_ACCESS_TOKEN": "<oceanengine-access-token>",
        "DOUDIAN_APP_KEY": "<doudian-app-key>",
        "DOUDIAN_APP_SECRET": "<doudian-app-secret>",
        "DOUDIAN_ACCESS_TOKEN": "<doudian-access-token>",
        "JD_APP_KEY": "<jd-app-key>",
        "JD_APP_SECRET": "<jd-app-secret>",
        "JD_ACCESS_TOKEN": "<jd-access-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce"
      ],
      "env": {
        "OCEANENGINE_APP_KEY": "<oceanengine-app-key>",
        "OCEANENGINE_APP_SECRET": "<oceanengine-app-secret>",
        "OCEANENGINE_ACCESS_TOKEN": "<oceanengine-access-token>",
        "DOUDIAN_APP_KEY": "<doudian-app-key>",
        "DOUDIAN_APP_SECRET": "<doudian-app-secret>",
        "DOUDIAN_ACCESS_TOKEN": "<doudian-access-token>",
        "JD_APP_KEY": "<jd-app-key>",
        "JD_APP_SECRET": "<jd-app-secret>",
        "JD_ACCESS_TOKEN": "<jd-access-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "cn-commerce": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-cn-commerce"
      ],
      "env": {
        "OCEANENGINE_APP_KEY": "<oceanengine-app-key>",
        "OCEANENGINE_APP_SECRET": "<oceanengine-app-secret>",
        "OCEANENGINE_ACCESS_TOKEN": "<oceanengine-access-token>",
        "DOUDIAN_APP_KEY": "<doudian-app-key>",
        "DOUDIAN_APP_SECRET": "<doudian-app-secret>",
        "DOUDIAN_ACCESS_TOKEN": "<doudian-access-token>",
        "JD_APP_KEY": "<jd-app-key>",
        "JD_APP_SECRET": "<jd-app-secret>",
        "JD_ACCESS_TOKEN": "<jd-access-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce"
      ],
      "env": {
        "OCEANENGINE_APP_KEY": "<oceanengine-app-key>",
        "OCEANENGINE_APP_SECRET": "<oceanengine-app-secret>",
        "OCEANENGINE_ACCESS_TOKEN": "<oceanengine-access-token>",
        "DOUDIAN_APP_KEY": "<doudian-app-key>",
        "DOUDIAN_APP_SECRET": "<doudian-app-secret>",
        "DOUDIAN_ACCESS_TOKEN": "<doudian-access-token>",
        "JD_APP_KEY": "<jd-app-key>",
        "JD_APP_SECRET": "<jd-app-secret>",
        "JD_ACCESS_TOKEN": "<jd-access-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OCEANENGINE_APP_KEY	—	yes	Ocean Engine open platform App Key (only needed for the oceanengine server)
OCEANENGINE_APP_SECRET	—	yes	Ocean Engine open platform App Secret
OCEANENGINE_ACCESS_TOKEN	—	yes	Ocean Engine OAuth access token
DOUDIAN_APP_KEY	—	yes	Douyin Shop App Key (only needed for the doudian server)
DOUDIAN_APP_SECRET	—	yes	Douyin Shop App Secret
DOUDIAN_SHOP_ID	—	—	Douyin Shop ID
DOUDIAN_ACCESS_TOKEN	—	yes	Douyin Shop OAuth access token
JD_APP_KEY	—	yes	JD open platform App Key (only needed for the jd server)
JD_APP_SECRET	—	yes	JD open platform App Secret
JD_ACCESS_TOKEN	—	yes	JD OAuth access token

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
2026-07-12 · 3mo ago · GitHub · v0.1.5
Package published
no data · npm/PyPI
Registry entry updated
2026-07-12 · 3mo ago · official registry · v0.1.5

FAQ

›How do I install the CN Commerce MCP server in Claude Code?

Run: claude mcp add cn-commerce -e OCEANENGINE_APP_KEY='<oceanengine-app-key>' -e OCEANENGINE_APP_SECRET='<oceanengine-app-secret>' -e OCEANENGINE_ACCESS_TOKEN='<oceanengine-access-token>' -e DOUDIAN_APP_KEY='<doudian-app-key>' -e DOUDIAN_APP_SECRET='<doudian-app-secret>' -e DOUDIAN_ACCESS_TOKEN='<doudian-access-token>' -e JD_APP_KEY='<jd-app-key>' -e JD_APP_SECRET='<jd-app-secret>' -e JD_ACCESS_TOKEN='<jd-access-token>' -- uvx mcp-cn-commerce. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does CN Commerce require an API key?

Yes. It expects OCEANENGINE_APP_KEY, OCEANENGINE_APP_SECRET, OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, of which 9 are secrets.

›Can I use CN Commerce as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is CN Commerce in the official MCP registry?

Yes, as io.github.TonyWang-hub/mcp-cn-commerce.