原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

MCP Cn Commerce

作者:TonyWang-hub版本 0.1.6i★ 102i在你的电脑上运行代码仓库 ↗
注册名称io.github.TonyWang-hub/mcp-cn-commerce

安装方法

What it does

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

  • Connects 在你的电脑上运行
  • Account or key Needs OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE · 1 setting to fill in (DOUDIAN_SHOP_ID)
  • Category 网店与支付

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度24/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应0/8上次检查时云端端点有响应
使用分36/100

质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

选择你使用的 AI 应用,然后复制设置。

用一句话让 AI 帮你安装

请帮我安装 MCP Cn Commerce。按照 https://mcp.popnx.com/i/tonywang-hub-mcp-cn-commerce.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月13日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude,但需要先准备

需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

让 AI 帮你安装

把这段话复制到 Claude 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Claude 安装 MCP server MCP Cn Commerce,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "cn-commerce": { "command": "uvx", "args": [ "mcp-cn-commerce", "start", "oceanengine" ], "env": { "OCEANENGINE_ACCESS_TOKEN": "your-value", "DOUDIAN_APP_KEY": "your-value", "DOUDIAN_APP_SECRET": "your-value", "DOUDIAN_SHOP_ID": "your-value", "DOUDIAN_ACCESS_TOKEN": "your-value", "JD_APP_KEY": "your-value", "JD_APP_SECRET": "your-value", "JD_ACCESS_TOKEN": "your-value", "TAOBAO_APP_KEY": "your-value", "TAOBAO_APP_SECRET": "your-value", "TAOBAO_ACCESS_TOKEN": "your-value", "PINDUODUO_CLIENT_ID": "your-value", "PINDUODUO_CLIENT_SECRET": "your-value", "PINDUODUO_ACCESS_TOKEN": "your-value", "KUAISHOU_APP_KEY": "your-value", "KUAISHOU_APP_SECRET": "your-value", "KUAISHOU_SIGN_SECRET": "your-value", "KUAISHOU_ACCESS_TOKEN": "your-value", "XHS_CLIENT_ID": "your-value", "XHS_CLIENT_SECRET": "your-value", "XHS_ACCESS_TOKEN": "your-value", "WX_APP_ID": "your-value", "WX_APP_SECRET": "your-value", "WX_ACCESS_TOKEN": "your-value", "WX_TOKEN_MODE": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE, DOUDIAN_SHOP_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 MCP Cn Commerce 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 MCP Cn Commerce 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 填写 1 项设置

    这些是程序设置,不是密钥,无需注册。按开发者的说明填写。

    • DOUDIAN_SHOP_ID 当 platform=doudian 时必填。
      查看英文原文Required when platform=doudian.

    说明为自动翻译,变量名保持原样;不确定时请查看原文。

  4. 打开电脑版 Claude 应用的设置文件

    SettingsDeveloperEdit Config

  5. 粘贴这些设置并保存文件

    {
      "mcpServers": {
        "cn-commerce": {
          "command": "uvx",
          "args": [
            "mcp-cn-commerce",
            "start",
            "oceanengine"
          ],
          "env": {
            "OCEANENGINE_ACCESS_TOKEN": "your-value",
            "DOUDIAN_APP_KEY": "your-value",
            "DOUDIAN_APP_SECRET": "your-value",
            "DOUDIAN_SHOP_ID": "your-value",
            "DOUDIAN_ACCESS_TOKEN": "your-value",
            "JD_APP_KEY": "your-value",
            "JD_APP_SECRET": "your-value",
            "JD_ACCESS_TOKEN": "your-value",
            "TAOBAO_APP_KEY": "your-value",
            "TAOBAO_APP_SECRET": "your-value",
            "TAOBAO_ACCESS_TOKEN": "your-value",
            "PINDUODUO_CLIENT_ID": "your-value",
            "PINDUODUO_CLIENT_SECRET": "your-value",
            "PINDUODUO_ACCESS_TOKEN": "your-value",
            "KUAISHOU_APP_KEY": "your-value",
            "KUAISHOU_APP_SECRET": "your-value",
            "KUAISHOU_SIGN_SECRET": "your-value",
            "KUAISHOU_ACCESS_TOKEN": "your-value",
            "XHS_CLIENT_ID": "your-value",
            "XHS_CLIENT_SECRET": "your-value",
            "XHS_ACCESS_TOKEN": "your-value",
            "WX_APP_ID": "your-value",
            "WX_APP_SECRET": "your-value",
            "WX_ACCESS_TOKEN": "your-value",
            "WX_TOKEN_MODE": "your-value"
          }
        }
      }
    }

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  6. 退出 Claude 再重新打开

  7. 试一试

    用 MCP Cn Commerce 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 MCP Cn Commerce,或回答中出现 MCP Cn Commerce 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

ChatGPT 暂时无法连接 MCP Cn Commerce

MCP Cn Commerce 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器

你可以改用这些方式

A · 使用能连接 MCP Cn Commerce 的应用

  • 需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
  • 需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次)
  • 需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次)
  • 需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次)

B · 网店与支付 类中能连接 ChatGPT 的其他服务器

从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的

可连接 Claude Code,但需要先准备

需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次)

让 AI 帮你安装

把这段话复制到 Claude Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Claude Code 安装 MCP server MCP Cn Commerce,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):claude mcp add --scope user cn-commerce --env OCEANENGINE_ACCESS_TOKEN=your-value --env DOUDIAN_APP_KEY=your-value --env DOUDIAN_APP_SECRET=your-value --env DOUDIAN_SHOP_ID=your-value --env DOUDIAN_ACCESS_TOKEN=your-value --env JD_APP_KEY=your-value --env JD_APP_SECRET=your-value --env JD_ACCESS_TOKEN=your-value --env TAOBAO_APP_KEY=your-value --env TAOBAO_APP_SECRET=your-value --env TAOBAO_ACCESS_TOKEN=your-value --env PINDUODUO_CLIENT_ID=your-value --env PINDUODUO_CLIENT_SECRET=your-value --env PINDUODUO_ACCESS_TOKEN=your-value --env KUAISHOU_APP_KEY=your-value --env KUAISHOU_APP_SECRET=your-value --env KUAISHOU_SIGN_SECRET=your-value --env KUAISHOU_ACCESS_TOKEN=your-value --env XHS_CLIENT_ID=your-value --env XHS_CLIENT_SECRET=your-value --env XHS_ACCESS_TOKEN=your-value --env WX_APP_ID=your-value --env WX_APP_SECRET=your-value --env WX_ACCESS_TOKEN=your-value --env WX_TOKEN_MODE=your-value -- uvx mcp-cn-commerce start oceanengine 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE, DOUDIAN_SHOP_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 MCP Cn Commerce 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 MCP Cn Commerce 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 填写 1 项设置

    这些是程序设置,不是密钥,无需注册。按开发者的说明填写。

    • DOUDIAN_SHOP_ID 当 platform=doudian 时必填。
      查看英文原文Required when platform=doudian.

    说明为自动翻译,变量名保持原样;不确定时请查看原文。

  4. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  5. 粘贴这条命令并按 Enter

    claude mcp add --scope user cn-commerce --env OCEANENGINE_ACCESS_TOKEN=your-value --env DOUDIAN_APP_KEY=your-value --env DOUDIAN_APP_SECRET=your-value --env DOUDIAN_SHOP_ID=your-value --env DOUDIAN_ACCESS_TOKEN=your-value --env JD_APP_KEY=your-value --env JD_APP_SECRET=your-value --env JD_ACCESS_TOKEN=your-value --env TAOBAO_APP_KEY=your-value --env TAOBAO_APP_SECRET=your-value --env TAOBAO_ACCESS_TOKEN=your-value --env PINDUODUO_CLIENT_ID=your-value --env PINDUODUO_CLIENT_SECRET=your-value --env PINDUODUO_ACCESS_TOKEN=your-value --env KUAISHOU_APP_KEY=your-value --env KUAISHOU_APP_SECRET=your-value --env KUAISHOU_SIGN_SECRET=your-value --env KUAISHOU_ACCESS_TOKEN=your-value --env XHS_CLIENT_ID=your-value --env XHS_CLIENT_SECRET=your-value --env XHS_ACCESS_TOKEN=your-value --env WX_APP_ID=your-value --env WX_APP_SECRET=your-value --env WX_ACCESS_TOKEN=your-value --env WX_TOKEN_MODE=your-value -- uvx mcp-cn-commerce start oceanengine

    按 Enter 前,把“your-value”改成你的密钥

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  6. 在 Claude Code 中输入 /mcp

    应能看到 MCP Cn Commerce 在列表中并显示已连接

  7. 试一试

    用 MCP Cn Commerce 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 MCP Cn Commerce,或回答中出现 MCP Cn Commerce 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor,但需要先准备

需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次)

让 AI 帮你安装

把这段话复制到 Cursor 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Cursor 安装 MCP server MCP Cn Commerce,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "cn-commerce": { "command": "uvx", "args": [ "mcp-cn-commerce", "start", "oceanengine" ], "env": { "OCEANENGINE_ACCESS_TOKEN": "your-value", "DOUDIAN_APP_KEY": "your-value", "DOUDIAN_APP_SECRET": "your-value", "DOUDIAN_SHOP_ID": "your-value", "DOUDIAN_ACCESS_TOKEN": "your-value", "JD_APP_KEY": "your-value", "JD_APP_SECRET": "your-value", "JD_ACCESS_TOKEN": "your-value", "TAOBAO_APP_KEY": "your-value", "TAOBAO_APP_SECRET": "your-value", "TAOBAO_ACCESS_TOKEN": "your-value", "PINDUODUO_CLIENT_ID": "your-value", "PINDUODUO_CLIENT_SECRET": "your-value", "PINDUODUO_ACCESS_TOKEN": "your-value", "KUAISHOU_APP_KEY": "your-value", "KUAISHOU_APP_SECRET": "your-value", "KUAISHOU_SIGN_SECRET": "your-value", "KUAISHOU_ACCESS_TOKEN": "your-value", "XHS_CLIENT_ID": "your-value", "XHS_CLIENT_SECRET": "your-value", "XHS_ACCESS_TOKEN": "your-value", "WX_APP_ID": "your-value", "WX_APP_SECRET": "your-value", "WX_ACCESS_TOKEN": "your-value", "WX_TOKEN_MODE": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE, DOUDIAN_SHOP_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 MCP Cn Commerce 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 MCP Cn Commerce 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 填写 1 项设置

    这些是程序设置,不是密钥,无需注册。按开发者的说明填写。

    • DOUDIAN_SHOP_ID 当 platform=doudian 时必填。
      查看英文原文Required when platform=doudian.

    说明为自动翻译,变量名保持原样;不确定时请查看原文。

  4. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  5. 填写你的密钥

    在 MCP Cn Commerce 的设置中,OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE, DOUDIAN_SHOP_ID 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  6. 在 Cursor 中以 Agent 模式打开 AI 聊天

  7. 试一试

    用 MCP Cn Commerce 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 MCP Cn Commerce,或回答中出现 MCP Cn Commerce 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code,但需要先准备

需要 MCP Cn Commerce 的密钥(在开发者网站创建) · 需要填写 1 项设置(DOUDIAN_SHOP_ID) · 需要先在电脑上安装 Python (uv)(只需一次)

让 AI 帮你安装

把这段话复制到 VS Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 VS Code 安装 MCP server MCP Cn Commerce,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "servers": { "cn-commerce": { "type": "stdio", "command": "uvx", "args": [ "mcp-cn-commerce", "start", "oceanengine" ], "env": { "OCEANENGINE_ACCESS_TOKEN": "your-value", "DOUDIAN_APP_KEY": "your-value", "DOUDIAN_APP_SECRET": "your-value", "DOUDIAN_SHOP_ID": "your-value", "DOUDIAN_ACCESS_TOKEN": "your-value", "JD_APP_KEY": "your-value", "JD_APP_SECRET": "your-value", "JD_ACCESS_TOKEN": "your-value", "TAOBAO_APP_KEY": "your-value", "TAOBAO_APP_SECRET": "your-value", "TAOBAO_ACCESS_TOKEN": "your-value", "PINDUODUO_CLIENT_ID": "your-value", "PINDUODUO_CLIENT_SECRET": "your-value", "PINDUODUO_ACCESS_TOKEN": "your-value", "KUAISHOU_APP_KEY": "your-value", "KUAISHOU_APP_SECRET": "your-value", "KUAISHOU_SIGN_SECRET": "your-value", "KUAISHOU_ACCESS_TOKEN": "your-value", "XHS_CLIENT_ID": "your-value", "XHS_CLIENT_SECRET": "your-value", "XHS_ACCESS_TOKEN": "your-value", "WX_APP_ID": "your-value", "WX_APP_SECRET": "your-value", "WX_ACCESS_TOKEN": "your-value", "WX_TOKEN_MODE": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE, DOUDIAN_SHOP_ID 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 MCP Cn Commerce 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 MCP Cn Commerce 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 填写 1 项设置

    这些是程序设置,不是密钥,无需注册。按开发者的说明填写。

    • DOUDIAN_SHOP_ID 当 platform=doudian 时必填。
      查看英文原文Required when platform=doudian.

    说明为自动翻译,变量名保持原样;不确定时请查看原文。

  4. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  5. 填写你的密钥

    在 MCP Cn Commerce 的设置中,OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE, DOUDIAN_SHOP_ID 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  6. 在 VS Code 中以 Agent 模式打开 AI 聊天

  7. 试一试

    用 MCP Cn Commerce 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 MCP Cn Commerce,或回答中出现 MCP Cn Commerce 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 MCP Cn Commerce 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

安装在电脑上

Claude Code

claude mcp add --scope user cn-commerce --env OCEANENGINE_ACCESS_TOKEN=your-value --env DOUDIAN_APP_KEY=your-value --env DOUDIAN_APP_SECRET=your-value --env DOUDIAN_SHOP_ID=your-value --env DOUDIAN_ACCESS_TOKEN=your-value --env JD_APP_KEY=your-value --env JD_APP_SECRET=your-value --env JD_ACCESS_TOKEN=your-value --env TAOBAO_APP_KEY=your-value --env TAOBAO_APP_SECRET=your-value --env TAOBAO_ACCESS_TOKEN=your-value --env PINDUODUO_CLIENT_ID=your-value --env PINDUODUO_CLIENT_SECRET=your-value --env PINDUODUO_ACCESS_TOKEN=your-value --env KUAISHOU_APP_KEY=your-value --env KUAISHOU_APP_SECRET=your-value --env KUAISHOU_SIGN_SECRET=your-value --env KUAISHOU_ACCESS_TOKEN=your-value --env XHS_CLIENT_ID=your-value --env XHS_CLIENT_SECRET=your-value --env XHS_ACCESS_TOKEN=your-value --env WX_APP_ID=your-value --env WX_APP_SECRET=your-value --env WX_ACCESS_TOKEN=your-value --env WX_TOKEN_MODE=your-value -- uvx mcp-cn-commerce start oceanengine

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce",
        "start",
        "oceanengine"
      ],
      "env": {
        "OCEANENGINE_ACCESS_TOKEN": "your-value",
        "DOUDIAN_APP_KEY": "your-value",
        "DOUDIAN_APP_SECRET": "your-value",
        "DOUDIAN_SHOP_ID": "your-value",
        "DOUDIAN_ACCESS_TOKEN": "your-value",
        "JD_APP_KEY": "your-value",
        "JD_APP_SECRET": "your-value",
        "JD_ACCESS_TOKEN": "your-value",
        "TAOBAO_APP_KEY": "your-value",
        "TAOBAO_APP_SECRET": "your-value",
        "TAOBAO_ACCESS_TOKEN": "your-value",
        "PINDUODUO_CLIENT_ID": "your-value",
        "PINDUODUO_CLIENT_SECRET": "your-value",
        "PINDUODUO_ACCESS_TOKEN": "your-value",
        "KUAISHOU_APP_KEY": "your-value",
        "KUAISHOU_APP_SECRET": "your-value",
        "KUAISHOU_SIGN_SECRET": "your-value",
        "KUAISHOU_ACCESS_TOKEN": "your-value",
        "XHS_CLIENT_ID": "your-value",
        "XHS_CLIENT_SECRET": "your-value",
        "XHS_ACCESS_TOKEN": "your-value",
        "WX_APP_ID": "your-value",
        "WX_APP_SECRET": "your-value",
        "WX_ACCESS_TOKEN": "your-value",
        "WX_TOKEN_MODE": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "cn-commerce": {
      "command": "uvx",
      "args": [
        "mcp-cn-commerce",
        "start",
        "oceanengine"
      ],
      "env": {
        "OCEANENGINE_ACCESS_TOKEN": "your-value",
        "DOUDIAN_APP_KEY": "your-value",
        "DOUDIAN_APP_SECRET": "your-value",
        "DOUDIAN_SHOP_ID": "your-value",
        "DOUDIAN_ACCESS_TOKEN": "your-value",
        "JD_APP_KEY": "your-value",
        "JD_APP_SECRET": "your-value",
        "JD_ACCESS_TOKEN": "your-value",
        "TAOBAO_APP_KEY": "your-value",
        "TAOBAO_APP_SECRET": "your-value",
        "TAOBAO_ACCESS_TOKEN": "your-value",
        "PINDUODUO_CLIENT_ID": "your-value",
        "PINDUODUO_CLIENT_SECRET": "your-value",
        "PINDUODUO_ACCESS_TOKEN": "your-value",
        "KUAISHOU_APP_KEY": "your-value",
        "KUAISHOU_APP_SECRET": "your-value",
        "KUAISHOU_SIGN_SECRET": "your-value",
        "KUAISHOU_ACCESS_TOKEN": "your-value",
        "XHS_CLIENT_ID": "your-value",
        "XHS_CLIENT_SECRET": "your-value",
        "XHS_ACCESS_TOKEN": "your-value",
        "WX_APP_ID": "your-value",
        "WX_APP_SECRET": "your-value",
        "WX_ACCESS_TOKEN": "your-value",
        "WX_TOKEN_MODE": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "cn-commerce": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-cn-commerce",
        "start",
        "oceanengine"
      ],
      "env": {
        "OCEANENGINE_ACCESS_TOKEN": "your-value",
        "DOUDIAN_APP_KEY": "your-value",
        "DOUDIAN_APP_SECRET": "your-value",
        "DOUDIAN_SHOP_ID": "your-value",
        "DOUDIAN_ACCESS_TOKEN": "your-value",
        "JD_APP_KEY": "your-value",
        "JD_APP_SECRET": "your-value",
        "JD_ACCESS_TOKEN": "your-value",
        "TAOBAO_APP_KEY": "your-value",
        "TAOBAO_APP_SECRET": "your-value",
        "TAOBAO_ACCESS_TOKEN": "your-value",
        "PINDUODUO_CLIENT_ID": "your-value",
        "PINDUODUO_CLIENT_SECRET": "your-value",
        "PINDUODUO_ACCESS_TOKEN": "your-value",
        "KUAISHOU_APP_KEY": "your-value",
        "KUAISHOU_APP_SECRET": "your-value",
        "KUAISHOU_SIGN_SECRET": "your-value",
        "KUAISHOU_ACCESS_TOKEN": "your-value",
        "XHS_CLIENT_ID": "your-value",
        "XHS_CLIENT_SECRET": "your-value",
        "XHS_ACCESS_TOKEN": "your-value",
        "WX_APP_ID": "your-value",
        "WX_APP_SECRET": "your-value",
        "WX_ACCESS_TOKEN": "your-value",
        "WX_TOKEN_MODE": "your-value"
      }
    }
  }
}

需要你填写的值

  • OCEANENGINE_ACCESS_TOKEN 机密 必填 env
    当 platform=oceanengine 时必填。
    查看英文原文Required when platform=oceanengine.
  • DOUDIAN_APP_KEY 机密 必填 env
    当 platform=doudian 时必填。
    查看英文原文Required when platform=doudian.
  • DOUDIAN_APP_SECRET 机密 必填 env
    当 platform=doudian 时必填。
    查看英文原文Required when platform=doudian.
  • DOUDIAN_SHOP_ID 必填 env
    当 platform=doudian 时必填。
    查看英文原文Required when platform=doudian.
  • DOUDIAN_ACCESS_TOKEN 机密 必填 env
    当 platform=doudian 时必填。
    查看英文原文Required when platform=doudian.
  • JD_APP_KEY 机密 必填 env
    当 platform=jd 时必填。
    查看英文原文Required when platform=jd.
  • JD_APP_SECRET 机密 必填 env
    当 platform=jd 时必填。
    查看英文原文Required when platform=jd.
  • JD_ACCESS_TOKEN 机密 必填 env
    当 platform=jd 时必填。
    查看英文原文Required when platform=jd.
  • TAOBAO_APP_KEY 机密 必填 env
    当 platform=taobao 时必填。
    查看英文原文Required when platform=taobao.
  • TAOBAO_APP_SECRET 机密 必填 env
    当 platform=taobao 时必填。
    查看英文原文Required when platform=taobao.
  • TAOBAO_ACCESS_TOKEN 机密 必填 env
    当 platform=taobao 时必填。
    查看英文原文Required when platform=taobao.
  • PINDUODUO_CLIENT_ID 机密 必填 env
    当 platform=pinduoduo 时必填。
    查看英文原文Required when platform=pinduoduo.
  • PINDUODUO_CLIENT_SECRET 机密 必填 env
    当 platform=pinduoduo 时必填。
    查看英文原文Required when platform=pinduoduo.
  • PINDUODUO_ACCESS_TOKEN 机密 必填 env
    当 platform=pinduoduo 时必填。
    查看英文原文Required when platform=pinduoduo.
  • KUAISHOU_APP_KEY 机密 必填 env
    当 platform=kuaishou 时必填。
    查看英文原文Required when platform=kuaishou.
  • KUAISHOU_APP_SECRET 机密 必填 env
    当 platform=kuaishou 时必填。
    查看英文原文Required when platform=kuaishou.
  • KUAISHOU_SIGN_SECRET 机密 必填 env
    当 platform=kuaishou 时必填。
    查看英文原文Required when platform=kuaishou.
  • KUAISHOU_ACCESS_TOKEN 机密 必填 env
    当 platform=kuaishou 时必填。
    查看英文原文Required when platform=kuaishou.
  • XHS_CLIENT_ID 机密 必填 env
    当 platform=xiaohongshu 时必填。
    查看英文原文Required when platform=xiaohongshu.
  • XHS_CLIENT_SECRET 机密 必填 env
    当 platform=xiaohongshu 时必填。
    查看英文原文Required when platform=xiaohongshu.
  • XHS_ACCESS_TOKEN 机密 必填 env
    当 platform=xiaohongshu 时必填。
    查看英文原文Required when platform=xiaohongshu.
  • WX_APP_ID 机密 必填 env
    在 managed 令牌模式下与 WX_APP_SECRET 一起必填。
    查看英文原文Required with WX_APP_SECRET in managed token mode.
  • WX_APP_SECRET 机密 必填 env
    在 managed 令牌模式下与 WX_APP_ID 一起必填。
    查看英文原文Required with WX_APP_ID in managed token mode.
  • WX_ACCESS_TOKEN 机密 必填 env
    在静态 token 模式下必填。提供时默认使用。
    查看英文原文Required in static token mode. Used by default when provided.
  • WX_TOKEN_MODE 机密 必填 env
    static 使用 WX_ACCESS_TOKEN;managed 使用 WX_APP_ID 和 WX_APP_SECRET 获取令牌。
    查看英文原文static uses WX_ACCESS_TOKEN; managed obtains tokens with WX_APP_ID and WX_APP_SECRET.

说明为自动翻译,变量名保持原样;不确定时请查看原文。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
84/周
连接方式
在你的电脑上运行
最新版本i
0.1.6
发布到注册中心i
2026年10月10日
代码最后更新i
2026年11月16日
作者
TonyWang-hub
软件包
pypi: mcp-cn-commerce
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

在你的电脑上运行,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

全部应用及其优缺点 →

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 TonyWang-hub 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于3天前

  • ✓ 通过

    有许可证

    使用 MIT

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

已公开的漏洞(OSV.dev)

OSV.dev 中没有 mcp-cn-commerce@0.1.6 的记录

只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/tonywang-hub-mcp-cn-commerce.svg)](https://mcp.popnx.com/en/servers/tonywang-hub-mcp-cn-commerce)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“网店与支付”中的其他服务器比较i

  • 星标数多于此分类中其他 2941 个服务器的 99%
  • 发布到注册中心的时间比此分类中其他 2941 个服务器的 41% 更新
  • 基础检查结果等于或优于此分类中其他 2941 个服务器的 99%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

MCP Cn Commerce 安全吗?

它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:OCEANENGINE_ACCESS_TOKEN, DOUDIAN_APP_KEY, DOUDIAN_APP_SECRET, DOUDIAN_ACCESS_TOKEN, JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN, TAOBAO_APP_KEY, TAOBAO_APP_SECRET, TAOBAO_ACCESS_TOKEN, PINDUODUO_CLIENT_ID, PINDUODUO_CLIENT_SECRET, PINDUODUO_ACCESS_TOKEN, KUAISHOU_APP_KEY, KUAISHOU_APP_SECRET, KUAISHOU_SIGN_SECRET, KUAISHOU_ACCESS_TOKEN, XHS_CLIENT_ID, XHS_CLIENT_SECRET, XHS_ACCESS_TOKEN, WX_APP_ID, WX_APP_SECRET, WX_ACCESS_TOKEN, WX_TOKEN_MODE

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于3天前,最新版本(0.1.6)于40天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它?

同一分类中有:Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者:stripe广泛使用★ 207213个月前更新

在云端运行✓ 服务方 · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

作者:flightclaw正在增长★ 862个月前更新

在云端运行✓ 服务方 · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

作者:trade-it-inc起步阶段★ 6234天前更新

在云端运行✓ 服务方 · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

作者:idealo起步阶段★ 286个月前更新

在云端运行✓ 服务方 · mcp.idealo.com
与相似项目对比
本项
MCP Cn Commerce
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
运行位置需要安装在电脑上在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装
需要密钥是否否否否否
可在 Claude 中按 + 添加否是否否否否
基础检查3/34/44/45/54/44/4
许可证MITMITMITCC0-1.0MITMIT
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

mcp-cn-commerce — 中国电商平台 MCP Server

🛒 让 AI Agent 直接读取中国电商平台的商家经营数据。 不做内容发布,只做经营数据的 MCP 连接器。

面向中国电商商家经营场景的开源 MCP Server 套件。通过支持 stdio MCP 的客户端接入。

搜索关键词: MCP Server, Model Context Protocol, 电商 MCP, AI Agent, 电商数据, 抖店 MCP, 京东 MCP, 巨量引擎 MCP, 淘宝 MCP, 拼多多 MCP, Python MCP, MCP 中国电商, 商家经营数据, 电商经营分析, AI 电商, Claude MCP

English | 简体中文

Core 0.1.6 版本说明:实际可用制品与对应源码提交,以 v0.1.6 GitHub Release、PyPI 0.1.6 和发布准备记录中的信息为准。本版本各 SDK 的 live_verified 均为 false;真实商家验收和后台对账未完成。

项目与咨询进展 · 工程/发布证据 · 更新记录


目录

  • 这是什么?
  • 为什么选择这个项目?
  • 平台覆盖
  • 快速开始
  • 工具参考
  • 架构
  • 安全
  • 使用示例 — 使用示例和场景
  • 常见问题
  • 参与贡献
  • 路线图

这是什么?

一个 MCP (Model Context Protocol) Server 套件(Monorepo),让 AI Agent 能够结构化地访问中国电商平台的商家经营数据。每个平台是一个独立的 MCP Server,按需安装使用:

  • 抖店、淘宝 — 已核订单与售后只读合同,优先进行真店样本核对。
  • 京东 — 已核订单、店铺和两项售后专项查询;完整退款采集仍有缺口。
  • 快手、小红书、微信小店 — 已核部分订单/售后读操作;主体绑定、采集范围及真实授权分别验收。
  • 巨量引擎 / 巨量千川 — 当前 SDK 已核广告主信息和账户余额;广告报表及授权账户树仍待补齐。
  • 拼多多 — 已保留平台入口,经营 SDK 查询因完整官方业务 schema 未取得而关闭;其他历史 MCP 入口不属已核支持。

这是 8 个 MCP 平台入口、155 个已注册工具的目录,包含历史兼容及明确不支持的入口。注册数量不代表已核合同或真店可用数量;当前 SDK 范围见逐操作能力表,有赞另提供 SDK-only 接入。

所有工具默认只读 — AI Agent 可以分析你的经营数据,但无法修改任何内容。

为什么选择这个项目?

本项目聚焦商家已授权的经营数据,提供平台适配、只读查询和确定性日报汇总。

  • 各平台独立 stdio 服务,按店铺已有授权配置。
  • 共享连接池、限流、重试、指标与脱敏。
  • 统一金额与时间处理;日报明确标记缺失数据和不完整分页。

平台开放 API、平台官方 MCP 与本项目的第三方 MCP 适配器是不同层次;详见官方接入核查。

当前可安排验证的场景:

  • 在应用确有权限时读取已核订单/售后接口,并与店铺后台样本核对。
  • 对已完成分页和归一化的记录生成确定性日报,明确金额未知与覆盖限制。
  • 先用模拟模板确认分析形式,再按操作合同安排真实只读验收。广告 ROAS、库存和评价等模板不证明对应数据源已经可用。

平台覆盖

平台当前已核 SDK 范围剩余边界(均未真店验收)官方入口
巨量引擎 / 千川广告主信息、账户余额广告报表迁移与授权账户树;无现成 Pro 广告 provider 承诺巨量开放平台
抖店订单列表/详情、售后列表/详情通用店铺信息不支持;支付优惠、实际退款和 90 天创建范围需后台核对抖店开放平台
京东订单列表/详情、店铺、售后列表/退款详情售后专项不是全部退款;通用退款及退款 Source 未开放京东零售开放平台
淘宝订单列表/增量/详情、退款列表/详情店铺信息仅 transport-only;应用字段权限与 payment 历史口径需核对淘宝开放平台
拼多多暂无可调用的经营 SDK 操作官方完整业务 schema 待取得,经营 SDK 读操作明确不支持拼多多开放平台
快手订单/退款列表及详情、店铺Pro 授权 open_id 与店铺主体绑定仍缺证据快手电商开放平台
小红书订单/售后列表及详情Source 所需订单查询时间与退款完成时间单位未闭合小红书开放平台
微信小店订单/售后列表及详情、店铺实际应用权限与游标终页需 live;Pro 同组件跨 tenant 委托另有缺口微信开发文档

本表是 SDK 摘要,不将历史 MCP 商品、库存、物流等入口全部标为当前已核合同。工具注册、合同已读、SDK 可调用、真实店铺通过分别记录;所有 SDK live_verified 仍为 false。当前证据见平台说明、官方接入核查与候选验收状态。CI 配置覆盖 Python 3.11/3.12/3.13,实际结果绑定具体提交。

Core 为各平台业务工具的 MCP tools/list 描述提供 contract_status、supported 和 live_verified。supported=false 的操作在发送平台请求前拒绝;历史兼容工具保留调用入口,明确标为 unverified。supported=true 只表示保留了调用映射,实际权限、合同范围和真店验收仍需分别确认。五项共享工具保持原有用途和描述,155 个注册工具的名称及输入输出结构不变。

快速开始

安装
安装 Core 0.1.6

使用 Python 3.11+;以下以 Python 3.12 为例,在项目虚拟环境安装:

mkdir -p mcp-cn-commerce-0.1.6

cd mcp-cn-commerce-0.1.6 python3.12 -m venv .venv source .venv/bin/activate python -m pip install "mcp-cn-commerce==0.1.6" mcp-cn-commerce --version

从源码安装时,先确认仓库中存在 v0.1.6 tag(验证命令成功),再检出该 tag:

git clone https://github.com/TonyWang-hub/mcp-cn-commerce.git

cd mcp-cn-commerce set -e git rev-parse --verify 'refs/tags/v0.1.6^{commit}' >/dev/null git checkout --detach v0.1.6 python3.12 -m venv .venv source .venv/bin/activate python -m pip install -c requirements-lock.txt .

开发者可在同一项目虚拟环境中使用可编辑安装:

python -m pip install -c requirements-lock.txt -e ".[dev]"

安装会写入项目的 .venv,不默认修改全局 Python。MCP 桌面客户端的 command 应填写该项目 .venv/bin/ 下命令的绝对路径;只在终端激活环境不保证桌面应用能找到它。其他操作系统使用对应的虚拟环境解释器/启动脚本路径。实际可安装制品和对应源码提交,以 v0.1.6 GitHub Release、PyPI 0.1.6 及发布准备记录为准。

配置凭证
# 巨量引擎 / 千川

export OCEANENGINE_APP_KEY="你的 App Key" export OCEANENGINE_APP_SECRET="你的 App Secret" export OCEANENGINE_ACCESS_TOKEN="你的 Access Token"

抖店

export DOUDIAN_APP_KEY="你的 App Key" export DOUDIAN_APP_SECRET="你的 App Secret" export DOUDIAN_SHOP_ID="你的店铺 ID" export DOUDIAN_ACCESS_TOKEN="你的 Access Token"

京东

export JD_APP_KEY="你的 App Key" export JD_APP_SECRET="你的 App Secret" export JD_ACCESS_TOKEN="你的 Access Token"

接入 AI Agent

本项目是标准 stdio MCP server,所有支持 MCP 协议的客户端都能直接接入。下面给出主流客户端的配置方式(凭证可在 shell 里 export,也可写进客户端配置的 env 段,两种都行)。

将下方 /absolute/path/to/mcp-cn-commerce 替换为所选安装目录的绝对路径;安装稳定版时使用该版本目录。桌面客户端还需在自己的 env 配置中设置凭证;终端中的 export 仅对继承该环境的进程生效。

Claude Desktop / Cherry Studio / Cline / Continue / Kimi Work(mcpServers JSON)

这类客户端用同一套 mcpServers 配置格式(Cline 写在 cline_mcp_settings.json,Claude Desktop 写在 claude_desktop_config.json):

{

"mcpServers": { "oceanengine": { "command": "/absolute/path/to/mcp-cn-commerce/.venv/bin/mcp-cn-oceanengine", "env": { "OCEANENGINE_APP_KEY": "你的 App Key", "OCEANENGINE_APP_SECRET": "你的 App Secret", "OCEANENGINE_ACCESS_TOKEN": "你的 Access Token" } }, "doudian": { "command": "/absolute/path/to/mcp-cn-commerce/.venv/bin/mcp-cn-doudian" }, "jd": { "command": "/absolute/path/to/mcp-cn-commerce/.venv/bin/mcp-cn-jd" } } }

Claude Code(CLI)
claude mcp add oceanengine \

--env OCEANENGINE_APP_KEY=你的Key \ --env OCEANENGINE_APP_SECRET=你的Secret \ --env OCEANENGINE_ACCESS_TOKEN=你的Token \ -- /absolute/path/to/mcp-cn-commerce/.venv/bin/mcp-cn-oceanengine

Codex(CLI)
codex mcp add oceanengine -- /absolute/path/to/mcp-cn-commerce/.venv/bin/mcp-cn-oceanengine

或写进 ~/.codex/config.toml:

[mcp_servers.oceanengine]

command = "/absolute/path/to/mcp-cn-commerce/.venv/bin/mcp-cn-oceanengine" env = { OCEANENGINE_APP_KEY = "你的Key", OCEANENGINE_APP_SECRET = "你的Secret", OCEANENGINE_ACCESS_TOKEN = "你的Token" }

OpenCode / MiMo Code(mcp 段)

这两者(MiMo Code 是 OpenCode 的 fork)用 mcp 配置格式:

{

"mcp": { "oceanengine": { "type": "local", "command": ["/absolute/path/to/mcp-cn-commerce/.venv/bin/mcp-cn-oceanengine"], "enabled": true, "environment": { "OCEANENGINE_APP_KEY": "你的Key", "OCEANENGINE_APP_SECRET": "你的Secret", "OCEANENGINE_ACCESS_TOKEN": "你的Token" } } } }

MiMo Code 还能直接从 Claude Code 自动导入已配置的 MCP server,无需重复配置。

其余平台 server 命令同理:mcp-cn-doudian、mcp-cn-jd、mcp-cn-taobao、mcp-cn-pinduoduo、mcp-cn-kuaishou、mcp-cn-xiaohongshu、mcp-cn-weixin-store。按需添加,凭证见上方配置凭证。

AI Agent 使用示例

确认对应工具合同、平台授权和数据范围后,可以安排以下只读查询;首次真店验收仍需与后台核对:

“读取抖店这个固定更新时间窗口的订单,告诉我还需要哪些分页和详情”

“查看淘宝这笔退款的状态、金额和完结时间”

“查询获准广告主的账户余额”

“导出我提供的已归一化订单记录,并注明缺失字段”

工作流模板 🆕

开箱即用的 AI 工作流模板,无需 API 凭证即可体验。以下预览均使用模拟数据,不证明真实平台数据源已接通。示例数据遵循日报输入契约;原始平台返回需先完成分页、字段归一化和完整性声明。

模板用途适用角色Demo
电商日报多平台 GMV/订单/退款汇总运营/老板查看 Demo
差评预警差评监控 + 原因分析客服/品控查看 Demo
客服分类退款原因分析 + 趋势客服主管查看 Demo
选品分析品类热度 + 竞品价格选品经理示例数据
达人匹配KOL 匹配 + ROI 预估投放优化师示例数据
📊 日报预览
┌────────┬──────────────┬──────────────┬────────┐

│ 指标 │ 今日 │ 昨日 │ 环比 │ ├────────┼──────────────┼──────────────┼────────┤ │ GMV │ ¥86,965.00 │ ¥88,900.00 │ -2.2% │ │ 订单量 │ 312 │ 309 │ +1.0% │ │ 客单价 │ ¥278.73 │ ¥287.70 │ -3.1% │ │ 退款率 │ 5.1% │ 4.6% │ +0.5pp │ └────────┴──────────────┴──────────────┴────────┘

平台对比 ┌──────────────────────┬──────────────┬──────┬────────┐ │ 平台 │ GMV │ 订单 │ 退款率 │ ├──────────────────────┼──────────────┼──────┼────────┤ │ 抖店 │ ¥28,950.00 │ 156 │ 5.1% │ │ 京东 │ ¥45,670.00 │ 89 │ 3.4% │ │ 小红书 │ ¥12,345.00 │ 67 │ 7.5% ⚠️│ └──────────────────────┴──────────────┴──────┴────────┘

⚠️ 异常预警: 🔴 小红书退款率 7.5% — 超过 5% 阈值 🔴 库存预警:「夏季新款男士短袖T恤 白色 XL」仅剩 32 件

🚨 差评预警预览
原因分布

质量问题 ████████████████████ 40% 色差 ██████████ 20% 尺码不合适 ██████████ 20% 做工粗糙 ██████████ 20%

逐条分析:

  1. 「洗了一次就掉色」— 抖店 ⭐ → 建议:联系买家道歉 + 检查同批次库存
  1. 「鞋码偏小,穿着挤脚」— 拼多多 ⭐⭐ → 建议:尺码表加注「建议拍大一码」
  1. 「颜色跟图片差太多」— 小红书 ⭐⭐ → 建议:重新拍摄商品图

全部模板:templates/ | 接入文档:docs/template-guide.md

工具汇总

此表统计注册入口及其目录类别,包含兼容和未核合同;可调用 SDK 范围另见能力表。

Server工具数覆盖类别
oceanengine23广告、千川、星图、素材、人群、优化
doudian25订单、商品、售后、物流、评价、直播、流量、营销、资金、店铺
jd20订单、商品、售后、物流、评价、价格、库存、营销、店铺
taobao18订单、商品、售后、物流、评价、店铺、营销、类目
pinduoduo18订单、商品、售后、物流、评价、店铺、营销、多多客
kuaishou17订单、商品、售后、物流、评价、店铺、营销
xiaohongshu18订单、商品、售后、物流、评价、店铺、营销、库存、财务
weixin_store16订单、商品、售后、物流、店铺、营销、供货、类目
合计155平台工具 + 每个 server 5 个公共工具(运维、导出、日报)

每个 server 还额外暴露 5 个跨平台公共工具(已计入上表):get_metrics(各接口延迟/成功/错误统计)、 get_traces(最近请求链路)、get_alerts(按实时指标评估告警规则)、export_data(导出记录为 CSV/JSON)、build_daily_report(按时区和数据完整性生成日报)。 请求链路追踪与指标在每次调用时自动采集。

每个工具的具体用法见各 servers/<平台>/server.py 源码。

架构

mcp-cn-commerce/

├── .github/workflows/test.yml # CI: push 自动跑 pytest ├── shared/ # 共享基类:签名/请求/分页 │ └── cn_commerce_base.py # 继承此基类即可新建平台 ├── servers/ # 所有平台 server(单一包,按需启动) │ ├── oceanengine/server.py ├── doudian/server.py │ ├── jd/server.py ├── taobao/server.py │ ├── pinduoduo/server.py ├── kuaishou/server.py │ ├── xiaohongshu/server.py └── weixin_store/server.py ├── docs/platforms.md # 8 平台 API 对比 & 认证方式矩阵 ├── README.md / README_en.md # 简体中文 / English └── LICENSE # MIT

单一包架构:Core 包含 8 个平台 server。按上方版本安装说明和逐操作能力表配置 MCP 客户端。

安全

本项目处理敏感的电商 API 凭证,安全保障:

  • 🔒 本地运行 — 凭证由本地读取,必要的认证信息发送给对应平台 API
  • 📖 代码开源 — 每一行代码都可审计
  • 👁️ 默认只读 — 全部平台工具只读数据,零写入/修改/删除操作
  • 📡 无数据收集 — 本项目不向自建服务上报使用数据;业务查询结果会返回你配置的 MCP/AI 客户端
  • 🖥️ 直连平台 API — 代码直接调用平台 API,无中间服务器或代理
  • 🔑 环境变量配置 — 凭证通过环境变量加载,绝不硬编码

常见问题

问:为什么不做内容发布(发视频/发笔记)? 答:内容发布(抖音发视频、小红书发笔记)已经有 HuiMei/Astron 等优秀项目覆盖了,没必要重复。商家经营数据(广告报表、订单、售后)才是 MCP 生态的空白地带。

问:需要企业资质吗? 答:部分平台需要:抖店需要企业/个体户资质,京东需要企业资质。拼多多个人可接入。详见 docs/platforms.md。

问:MCP 和 CLI 哪个更好? 答:MCP 给 AI Agent 用(结构化

只显示了开头部分;其余内容请在仓库中阅读