Bangbangmart

棒棒玛特 MCP Server

English | 中文

---

棒棒玛特 MCP

棒棒玛特（BangBangMart）的 MCP（模型上下文协议）服务器 —— 专为 AI 智能体交互而设计的在线零食商店。

MCP 服务器已上线：https://www.bangbangmart.com/mcp（Streamable HTTP，无状态，无需安装）

简介

棒棒玛特是一个 AI 优先设计的电商站点：所有接口均返回纯文本并包裹在极简 HTML 中，便于大模型直接消费。MCP 服务器以结构化工具的形式暴露了相同的商品目录、下单和订单查询功能。

• 站点主页：https://www.bangbangmart.com
• MCP 接口：https://www.bangbangmart.com/mcp
• 协议：MCP Streamable HTTP（无状态，每次请求独立 transport）
• 服务器名称：bangbangmart

工具列表

工具	说明
search_products	按关键词、价格、是否促销搜索零食目录，返回商品 ID、价格和购买链接
get_product	通过 product_id（如 p_snacks_0001）获取单个商品的完整详情
checkout	为一个或多个商品创建订单并获取支付链接，需要 API Key
get_order_status	通过 order_id（格式：ord_XXXXXXX）查询订单状态
get_orders	列出当前用户的所有订单，需要 API Key
pay_order	确认模拟支付

工具参数详情

checkout 支持两种下单方式：

• 单商品：传 product_id（如 p_snacks_0001）和 qty
• 多商品：传 items 字符串，格式为逗号分隔的 product_id:qty 对，如 p_snacks_0001:2,p_snacks_0014:1

API Key

checkout 和 get_orders 需要 API Key。API Key 以 sk_ 开头，请访问 /human/account 登录并生成。

API Key 通过 HTTP 请求头传递，而非作为工具参数——请在 MCP 客户端配置中添加请求头：

BANGBANGMART_API_KEY: sk_你的密钥

MCP 客户端配置

服务器已托管，无需本地安装，直接将 MCP 客户端指向远程接口即可。

Cursor

{
  "mcpServers": {
    "bangbangmart": {
      "type": "http",
      "url": "https://www.bangbangmart.com/mcp",
      "headers": {
        "BANGBANGMART_API_KEY": "sk_你的密钥"
      }
    }
  }
}

Claude Code

claude mcp add --transport http bangbangmart https://www.bangbangmart.com/mcp \
  --header "BANGBANGMART_API_KEY=sk_你的密钥"

Visual Studio Code

{
  "servers": {
    "bangbangmart": {
      "type": "http",
      "url": "https://www.bangbangmart.com/mcp",
      "headers": {
        "BANGBANGMART_API_KEY": "sk_你的密钥"
      }
    }
  }
}

Kimi Code

kimi mcp add --transport http bangbangmart https://www.bangbangmart.com/mcp \
  --header "BANGBANGMART_API_KEY: sk_你的密钥"

智能体工作流示例

1. 调用 search_products（如 q: "薯片"）查找商品及其 ID
2. 调用 get_product 传入 product_id 查看完整详情
3. 请用户提供其 API Key（可在 /human/account 生成），并将其配置到 MCP 客户端的请求头中
4. 调用 checkout 传入 product_id 和 qty（或多商品 items）下单
5. 将响应中的支付链接展示给用户
6. 调用 pay_order 传入 order_id 确认模拟支付
7. 调用 get_order_status 或 get_orders 验证订单状态

许可证

MIT — 详见 LICENSE

---

BangBangMart MCP

MCP (Model Context Protocol) server for 棒棒玛特 (BangBangMart) — an online snack shop designed for AI agent interaction.

The MCP server is live at https://www.bangbangmart.com/mcp (Streamable HTTP, stateless, no installation required).

Overview

BangBangMart is an e-commerce site built AI-first: all routes return plain text wrapped in minimal HTML, making them easy for LLMs to consume directly. The MCP server exposes the same catalog, checkout, and order functionality as structured tools.

• Live site: https://www.bangbangmart.com
• MCP endpoint: https://www.bangbangmart.com/mcp
• Protocol: MCP Streamable HTTP (stateless, one transport per request)
• Server name: bangbangmart

工具

工具	描述
search_products	按关键词、价格和促销状态搜索并筛选零食目录。返回商品 ID、价格和购买链接。
get_product	根据 product_id（例如 p_snacks_0001）获取单个商品的完整详情。
checkout	为一个或多个商品创建订单并获取支付 URL。需要 API 密钥。
get_order_status	根据 order_id（格式：ord_XXXXXXX）查询订单状态。
get_orders	列出经过身份验证的用户的所有订单。需要 API 密钥。
pay_order	确认订单的模拟支付。

工具参数详情

checkout 支持两种下单模式：

• 单个商品：传入 product_id（例如 p_snacks_0001）和 qty
• 多个商品：传入由逗号分隔的 product_id:qty 对组成的 items 字符串，例如 p_snacks_0001:2,p_snacks_0014:1

API 密钥

checkout 和 get_orders 需要 API 密钥。API 密钥以 sk_ 开头，可在 /human/account 生成。

API 密钥通过 HTTP 标头传递到 MCP 客户端配置中，而不是作为工具参数传递：

BANGBANGMART_API_KEY: sk_your_key_here

MCP 客户端配置

由于服务托管在远程，无需本地安装。配置 MCP 客户端以连接到远程端点。

Cursor

{
  "mcpServers": {
    "bangbangmart": {
      "type": "http",
      "url": "https://www.bangbangmart.com/mcp",
      "headers": {
        "BANGBANGMART_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add --transport http bangbangmart https://www.bangbangmart.com/mcp \
  --header "BANGBANGMART_API_KEY=sk_your_key_here"

Visual Studio Code

{
  "servers": {
    "bangbangmart": {
      "type": "http",
      "url": "https://www.bangbangmart.com/mcp",
      "headers": {
        "BANGBANGMART_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Kimi Code

kimi mcp add --transport http bangbangmart https://www.bangbangmart.com/mcp \
  --header "BANGBANGMART_API_KEY=sk_your_key_here"

Agent 工作流示例

1. 使用关键词（例如 q: "薯片"）调用 search_products，查找商品及其 ID。
2. 使用 product_id 调用 get_product，查看完整详情。
3. 向用户索取 API 密钥（在 /human/account 生成），并将其添加到 MCP 客户端配置标头中。
4. 使用 product_id 和 qty（或包含多个商品的 items）调用 checkout，下单。
5. 将响应中的支付 URL 提供给用户。
6. 使用 order_id 调用 pay_order，确认模拟支付。
7. 调用 get_order_status 或 get_orders 进行核实。

许可证

MIT——详见 LICENSE。