拼多多商家版 MCP Server

通过 MCP (Model Context Protocol) 协议接入拼多多商家开放平台 API，让 AI 助手可以直接管理你的拼多多店铺。

功能模块

共 39 个工具，覆盖商家日常经营的核心场景。

快速开始

1. 安装依赖

cd pdd-mcp-server
npm install

2. 构建

npm run build

3. 配置凭证

复制 .env.example 为 .env 并填入你的拼多多开放平台凭证：

cp .env.example .env

编辑 .env：

PDD_CLIENT_ID=你的client_id
PDD_CLIENT_SECRET=你的client_secret
PDD_ACCESS_TOKEN=
PDD_REFRESH_TOKEN=

4. 在 QoderWork 中配置 MCP

在 QoderWork 的 MCP 设置中添加：

{
  "mcpServers": {
    "pdd": {
      "command": "node",
      "args": ["/你的路径/pdd-mcp-server/dist/index.js"],
      "env": {
        "PDD_CLIENT_ID": "你的client_id",
        "PDD_CLIENT_SECRET": "你的client_secret",
        "PDD_ACCESS_TOKEN": "你的access_token",
        "PDD_REFRESH_TOKEN": "你的refresh_token"
      }
    }
  }
}

5. 验证连接

配置完成后，在 QoderWork 中调用 pdd_status 工具检查连接状态。

---

如何申请拼多多开放平台开发者账号

第一步：注册开放平台账号

1. 访问 拼多多开放平台
2. 用你的商家账号（拼多多商家后台的账号）登录
3. 进入「应用管理」页面

第二步：创建应用

1. 点击「创建应用」
2. 填写应用信息：
   • 应用名称：给你的 MCP 工具起个名字，比如 “我的店铺助手”
   • 应用类型：选择「自用型」（只给自己店铺用）
   • 应用描述：简单说明用途即可
3. 提交后等待审核（通常 1-3 个工作日）

第三步：获取凭证

审核通过后，在应用详情页可以看到：

• client_id（也叫 App Key）
• client_secret（也叫 App Secret）

将这两个值填入 .env 文件或 QoderWork MCP 配置的 env 中。

第四步：OAuth 授权获取 Token

拼多多 API 需要 access_token 才能调用。授权流程：

1. 在 QoderWork 中调用 pdd_oauth_url 工具，传入你的回调地址
2. 在浏览器中打开返回的授权链接
3. 用商家账号登录并授权
4. 授权成功后，浏览器会跳转到你的回调地址，URL 中带有 code 参数
5. 将这个 code 传给 pdd_oauth_token 工具
6. 工具会返回 access_token 和 refresh_token，并自动保存到 ~/.pdd-mcp/config.json

提示：access_token 有效期有限，过期后系统会自动用 refresh_token 刷新。如果刷新也失败了，需要重新走授权流程。

常见问题

Q: 审核不通过怎么办？ A: 确认应用描述写清楚用途，自用型应用审核相对宽松。如果是个人店铺，确保已绑定手机号和身份证。

Q: token 过期了怎么办？ A: 系统内置了自动刷新机制。如果 refresh_token 也过期了（通常有效期更长），需要重新走 OAuth 授权流程。

Q: 支持多店铺吗？ A: 当前版本支持单店铺。如需多店铺，可以运行多个 MCP server 实例，每个配置不同的凭证。

---

项目结构

pdd-mcp-server/
├── src/
│   ├── index.ts          # MCP Server 入口
│   ├── config.ts         # 配置管理（.env + 持久化）
│   ├── pdd-client.ts     # API 客户端（签名、请求、Token）
│   └── tools/
│       ├── index.ts      # 工具注册中心
│       ├── order.ts      # 订单管理（7个工具）
│       ├── goods.ts      # 商品管理（9个工具）
│       ├── refund.ts     # 售后管理（7个工具）
│       ├── logistics.ts  # 物流管理（5个工具）
│       ├── mall.ts       # 店铺数据（7个工具）
│       └── security.ts   # 安全/授权（4个工具）
├── .env.example          # 环境变量模板
├── package.json
└── tsconfig.json

技术细节

• 签名算法：MD5 签名，参数按 key 字母序排列，前后包裹 client_secret
• 传输协议：stdio（MCP 标准传输方式）
• Token 存储：~/.pdd-mcp/config.json（自动持久化）
• 自动刷新：access_token 过期时自动用 refresh_token 刷新并重试
• 错误处理：统一错误格式，包含 error_code 和 error_msg

License

MIT