Skip to main content
Glama
MCP Taobao Server

MCP Taobao Server

by ganyu123456

MCP Taobao Server(淘宝闪购 / 饿了么外卖)

为大模型提供淘宝闪购点外卖能力的 MCP 服务器:搜附近店 → 看菜单 → 加入购物车 → 生成待支付订单。 下单类工具会走到「确认订单/支付页」就停住,绝不自动付款;登录与付款都由你人工经 noVNC 完成。

说明:淘宝闪购/外卖没有面向个人的下单开放 API。本 server 通过一个持久化的有头 Chromium 自动化饿了么 H5(h5.ele.me);部署在无屏 Linux 服务器时用 Xvfb 提供虚拟显示, 人工操作(登录的短信/滑块、最终付款)通过 noVNC 远程接管虚拟桌面完成。

⚠️ 登录态是会话级:服务进程存活期间有效,进程重启需重新登录一次。因此以单一常驻进程运行。

功能

  • 登录(人工):shangou_open_login 打开饿了么登录页(手机号+短信验证码+滑块),由人经 noVNC 完成;shangou_check_login 查登录态

  • 收货地址:shangou_list_addresses 列常用地址,shangou_set_address 选定地址(决定配送范围)

  • 搜附近店:shangou_search(奶茶/汉堡/超市/水果…)

  • 店内菜单:shangou_shop_menu

  • 加入购物车:shangou_add_to_cart

  • 查看购物车:shangou_view_cart

  • 生成待支付订单:shangou_create_order——走到支付页即停,返回金额+截图+人工付款指引,含金额上限护栏

  • 提交并取支付链接:shangou_submit_order——点『提交订单』进入支付宝收银台即停(不代付),返回收银台链接,人工点链接付款

  • 支持 stdio 与 SSE 两种传输

成熟度:登录 + 收货地址 + 搜店/进店/加购/店内搜/结算/提交已按真实页面实测校正 (饿了么 H5 为 tiga 影子DOM + 淘宝闪购 newretail 页,用文本/aria-label/坐标 tap 驱动)。 触发滑块/风控时工具返回结构化提示,请用 noVNC 人工处理。

Related MCP server: mcp-amazon

安全护栏

  • 绝不自动付款/自动登录:登录与付款都是人工点击(noVNC)。

  • 金额上限:MCP_TAOBAO_MAX_ORDER_AMOUNT(默认 100 元),确认页金额超限则拒绝提交并提示。

  • 触发风控:检测到滑块/验证即停并提示人工处理,不盲目重试。

快速开始

1. 本地开发运行

python -m venv .venv && source .venv/bin/activate
pip install -e ".[sse]"
playwright install chromium

# stdio
mcp-taobao-server
# SSE
MCP_TRANSPORT=sse MCP_PORT=8094 mcp-taobao-server

2. 点外卖流程

  1. shangou_open_login → 经 noVNC 用手机+短信+滑块登录

  2. shangou_list_addresses → shangou_set_address 选收货地址(决定配送城市/范围,务必先选对)

  3. shangou_search 搜店 → shangou_shop_menu 看菜 → shangou_add_to_cart 加购(达起送才能结算)

  4. shangou_create_order → 走到确认页,返回实付金额、截图(未提交、未付款)

  5. 核对无误后二选一付款:

    • shangou_submit_order → 提交订单,返回支付宝收银台链接,在已登录浏览器(noVNC:6080)点链接付款

    • 或直接在 noVNC(http://<服务器IP>:6080/vnc.html)里手动点『提交订单』并付款

部署

cp .env.example .env      # 按需改默认定位、金额上限、VNC 密码
docker compose up -d
  • 镜像基于 python:3.11-slim,内含 Chromium + Xvfb + x11vnc + noVNC + 精简中文字体,体积约 1.2GB。

  • 暴露端口:8094(MCP SSE)、6080(noVNC 网页,人工登录/付款接管)。

  • 登录态卷 taobao_profile:/data/profile 持久化 cookie(注意饿了么登录态仍是会话级)。

  • 推送 v* tag 触发 GitHub Actions:amd64 + arm64 原生构建、推 Harbor、多架构 manifest、GitHub Release。 需仓库 secrets HARBOR_USERNAME / HARBOR_PASSWORD。

MCP 客户端配置

SSE:

{ "mcpServers": { "shangou": { "url": "http://<your-server>:8094/sse" } } }

stdio:

{
  "mcpServers": {
    "shangou": {
      "command": "mcp-taobao-server",
      "env": {
        "MCP_TAOBAO_USER_DATA_DIR": "./profile",
        "MCP_TAOBAO_LAT": "32.06",
        "MCP_TAOBAO_LNG": "118.80",
        "MCP_TAOBAO_MAX_ORDER_AMOUNT": "100"
      }
    }
  }
}

环境变量

变量

默认值

说明

MCP_TRANSPORT

stdio

stdio 或 sse

MCP_HOST / MCP_PORT

0.0.0.0 / 8094

SSE 监听地址

MCP_TAOBAO_USER_DATA_DIR

./profile

浏览器持久化 profile

MCP_TAOBAO_HEADLESS

false

有头(配 Xvfb)/无头

MCP_TAOBAO_LAT / MCP_TAOBAO_LNG

32.06 / 118.80

默认定位(决定“附近”范围;选地址后以地址为准)

MCP_TAOBAO_TIMEOUT

30

页面操作超时(秒)

MCP_TAOBAO_MAX_RESULTS

10

搜索/菜单返回条数上限

MCP_TAOBAO_MAX_ORDER_AMOUNT

100

下单金额上限(元),0=不限制

MCP_TAOBAO_SLOWMO

0

每步操作放慢(毫秒)

DISPLAY

:99

Xvfb 虚拟显示编号(容器内)

MCP_TAOBAO_SCREEN

1280x1024x24

虚拟屏分辨率

MCP_TAOBAO_NOVNC_PORT

6080

noVNC 网页端口

MCP_TAOBAO_VNC_PASSWORD

(空)

VNC 密码,空=无密码(建议放内网/反代后)

MCP 工具列表

工具

说明

是否需登录

shangou_open_login

打开饿了么登录页(人工经 noVNC 完成)

否(用于登录)

shangou_check_login

查询登录态

否

shangou_list_addresses

列出常用收货地址

是

shangou_set_address

选定收货地址

是

shangou_search

搜附近店/美食

是

shangou_shop_menu

查看店内菜单

是

shangou_add_to_cart

加入购物车

是

shangou_view_cart

查看购物车

是

shangou_create_order

生成待支付订单(停在支付前)

是

shangou_submit_order

提交订单并返回支付宝收银台链接(停在收银台,不代付)

是

shangou_get_server_status

配置与可用性自检

否

项目结构

04-mcp-taobao-server/
├── Dockerfile / docker-compose.yaml / entrypoint.sh / .env.example
├── pyproject.toml / requirements.txt
├── .github/workflows/build-release.yaml
└── src/mcp_taobao_server/
    ├── server.py                 # 入口 + shangou_* 工具 + stdio/sse
    └── platforms/
        ├── base.py               # BasePlatform / 结果 dataclass / PlatformError
        └── eleme.py              # 饿了么 H5 Playwright 驱动(登录/地址/搜店/加购/下单停在支付前)

许可

MIT

Available Tools

11 tools
shangou_add_to_cartA

把某店铺的菜品加入购物车。参数 shop=店铺ID/URL;item=菜品名称;quantity=份数(默认1)。可能需先选规格,返回是否成功及截图。

Inputs: item (required), shop (required), quantity.

shangou_check_loginA

检查是否已登录饿了么(淘宝闪购外卖)。未登录请调 shangou_open_login,并在 noVNC 里人工完成手机+短信+滑块登录。

Inputs: no named parameters.

shangou_create_orderA

生成待支付外卖订单:点『去结算』走到确认订单/支付页即【停止,绝不提交付款】,返回金额、页面截图与人工付款指引。参数 shop=店铺ID/URL(需已在该店加购)。金额超过服务端上限(MCP_TAOBAO_MAX_ORDER_AMOUNT)会被拦截。付款请经 noVNC(:6080)在浏览器手动完成。

Inputs: shop (required).

shangou_get_server_statusA

查询服务配置与可用性(是否装好 playwright、profile 目录、有头/无头、默认定位、金额上限等)。无需登录即可调用。

Inputs: no named parameters.

shangou_list_addressesA

列出账号里的常用收货地址(index/名称/联系人)。下单前需先用 shangou_set_address 选定一个地址。

Inputs: no named parameters.

shangou_open_loginA

打开饿了么登录页(手机号+短信验证码+滑块)。因含短信与滑块验证,须由人在 noVNC(http://<服务器IP>:6080/vnc.html) 的浏览器窗口里完成;返回当前页截图与操作指引。登录态在服务进程存活期间有效。

Inputs: no named parameters.

shangou_set_addressA

选择收货地址以确定配送范围。参数 keyword=地址关键词(如'马家店春华园'),或 index=shangou_list_addresses 里的序号(从0起)。选好后即可搜附近店。

Inputs: index, keyword.

shangou_shop_menuA

查看某店铺的菜单/商品。参数 shop=店铺ID或店铺URL;limit=返回条数。返回菜品名称与价格(尽力解析)。

Inputs: shop (required), limit.

shangou_submit_orderA

【会真实提交订单】在确认订单页点『提交订单』,进入支付宝收银台即【停止,不输密码、不代付】,返回收银台支付链接与截图。仅在用户明确同意下单后调用(通常先 shangou_create_order 核对金额)。参数 shop=店铺序号。金额超上限(MCP_TAOBAO_MAX_ORDER_AMOUNT)会被拒绝。收银台链接与登录态/时效绑定,请在已登录浏览器(服务器为 noVNC:6080)打开付款。

Inputs: shop (required).

shangou_view_cartA

查看某店铺当前购物车内容(尽力解析菜品与价格)。参数 shop=店铺ID/URL。

Inputs: shop (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct action and resource (login, search, address management, cart, orders, server status). No two tools have ambiguous boundaries; the sequential steps (create_order vs submit_order) are clearly differentiated.

    Naming Consistency4/5

    All tools use the 'shangou_' prefix and verb_noun pattern (e.g., check_login, set_address, add_to_cart). The naming is mostly consistent, though 'shop_menu' deviates slightly from a clearer 'get_shop_menu'. Overall predictable and readable.

    Tool Count5/5

    11 tools is well-scoped for a food ordering server. It covers the entire workflow from login to order submission without unnecessary bloat or missing critical steps.

    Completeness4/5

    The set covers the core ordering flow (login, search, address, menu, cart, order creation, submission). Minor gaps exist (e.g., no remove-from-cart tool, no order history), but the stated purpose is fulfilled effectively.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers