棒棒玛特 Mcp

Created By
XhanGlobal3 months ago
Overview

棒棒玛特 MCP Server

English | 中文


棒棒玛特 MCP

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

MCP 服务器已上线:https://www.bangbangmart.com/mcp(Streamable HTTP,无状态,无需安装)

简介

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

工具列表

工具说明
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

checkoutget_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_idqty(或多商品 items)下单
  5. 将响应中的支付链接展示给用户
  6. 调用 pay_order 传入 order_id 确认模拟支付
  7. 调用 get_order_statusget_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.

Tools

ToolDescription
search_productsSearch and filter the snack catalog by keyword, price, sale status. Returns product IDs, prices, and buy links.
get_productGet full details for a single product by product_id (e.g. p_snacks_0001).
checkoutCreate an order for one or more products and get a payment URL. Requires an API key.
get_order_statusLook up the status of an order by order_id (format: ord_XXXXXXX).
get_ordersList all orders for the authenticated viewer. Requires an API key.
pay_orderConfirm mock payment for an order.

Tool parameter details

checkout supports two ordering modes:

  • Single product: pass product_id (e.g. p_snacks_0001) and qty
  • Multiple products: pass an items string of comma-separated product_id:qty pairs, e.g. p_snacks_0001:2,p_snacks_0014:1

API keys

checkout and get_orders require an API key. API keys start with sk_ and can be generated at /human/account.

The API key is passed as an HTTP header in your MCP client config — not as a tool argument:

BANGBANGMART_API_KEY: sk_your_key_here

MCP client configuration

Because the server is hosted, no local installation is needed. Configure your MCP client to point at the remote endpoint.

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"

Example agent workflow

  1. Call search_products with a keyword (e.g. q: "薯片") to find products and their IDs.
  2. Call get_product with a product_id to see full details.
  3. Ask the user for their API key (generate one at /human/account) and add it to the MCP client config headers.
  4. Call checkout with the product_id and qty (or multi-product items) to place an order.
  5. Present the payment URL from the response to the user.
  6. Call pay_order with the order_id to confirm mock payment.
  7. Call get_order_status or get_orders to verify.

License

MIT — see LICENSE.

Server Config

{
  "mcpServers": {
    "bangbangmart": {
      "type": "http",
      "url": "https://www.bangbangmart.com/mcp",
      "headers": {
        "BANGBANGMART_API_KEY": "sk_你的密钥"
      }
    }
  }
}
Project Info
Created At
3 months ago
Updated At
3 months ago
Author Name
XhanGlobal
Star
-
Language
-
License
-
Category

Recommend Servers

View All
GovQL
@Alex Stout

# govql-mcp-server An MCP (Model Context Protocol) server for [GovQL](https://govql.us) — gives AI clients like Claude Desktop, Claude Code, and Cursor direct access to the US Congressional GraphQL API at [api.govql.us/graphql](https://api.govql.us/graphql) without bespoke HTTP wiring. For the design rationale (why FastMCP-Python, the passthrough+curated philosophy, roadmap through v0.4), see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md). ## What you can do with it Ask an agent questions like: - *"How did Vermont's two senators vote on the most recent nomination?"* - *"Which legislators in the 118th Congress switched parties during their service?"* - *"Compare Senator Sanders' voting record to Senator Murkowski's on cloture votes in the most recent Congress."* The agent picks the right tool, writes the GraphQL query against the live schema, and parses the response — no manual API wrangling. ## Install The server runs as a per-client subprocess over stdio. Pick your client: ### Claude Desktop Edit `claude_desktop_config.json` (Settings → Developer → Edit Config): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` Restart Claude Desktop. The `govql` tools appear in the tools panel. ### Claude Code Add to `.mcp.json` in your project (or `~/.mcp.json` for global): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` ### Cursor Settings → MCP → Add Server. Use the same `command` / `args` as above. ### Other clients Any MCP-compatible client that supports stdio servers will work. The command is `uvx govql-mcp-server` with no required arguments. ## Tools | Tool | Purpose | |---|---| | `execute_graphql` | Run any GraphQL query against the GovQL endpoint. Returns the result plus an `last_ingest` timestamp so the agent can reason about data freshness. | | `list_types` | Returns the names and kinds of every type in the GovQL schema. Optional `kind` filter (`"OBJECT"`, `"INPUT_OBJECT"`, `"ENUM"`, etc.) to narrow further. Start here when you don't know what's queryable. | | `describe_type` | Returns one type's full details — fields, arg signatures, input fields, enum values. Call after `list_types` to learn the shape of a specific type before writing a query. | ## Configuration All env vars are optional — the package is zero-config for end users. | Env var | Default | Purpose | |---|---|---| | `GOVQL_ENDPOINT` | `https://api.govql.us/graphql` | Endpoint to query. Override to point at a local dev stack. | | `GOVQL_TIMEOUT_MS` | `30000` | Per-request HTTP timeout. | | `LOG_LEVEL` | `INFO` | Logging level. Logs go to stderr only (stdout is reserved for the MCP transport). | ## Limits (enforced by the upstream API) - Max query depth: 10 - Max query complexity: ~10 billion points (`first: N` multiplies child cost by N — keep page sizes reasonable on deeply nested queries) - Rate limit: 100 requests / 60 s per source IP A depth or complexity violation surfaces as a GraphQL `errors` entry in the tool response so the agent can adjust and retry. ## Data freshness Every `execute_graphql` response includes a `last_ingest` ISO timestamp. Vote data refreshes hourly; legislator data refreshes daily. ## Status Version 0.1.0 ships three foundational tools: a GraphQL passthrough (`execute_graphql`) and two narrow schema-discovery tools (`list_types`, `describe_type`). Curated higher-level tools (`find_legislator`, `get_voting_record`, `compare_voters`, etc.) are planned for subsequent releases — see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md) for the roadmap. ## Links - [GovQL project site](https://govql.us) - [GraphQL API](https://api.govql.us/graphql) - [Source / issues](https://github.com/govql/govql)

a day ago
Meok Bs7121 Mcp

9 hours ago