Nanocart Mcp

io.github.ByteBunny-io由 GitHub 账号 ByteBunny-io 发布v1.2.0更新于 Oct 24, 2026

Manage your NanoCart store from any AI agent: products, orders, coupons, subscribers, reports.

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

NanoCart 官方 MCP 服务器，让 AI 助手管理 NanoCart 店铺：商品、订单、优惠券、订阅者和销售报表。

可以做什么
  • 列出、创建和更新商品，包括变体与图片
  • 管理订单，包括填写物流单号并标记为已发货
  • 创建和管理优惠券、分类、订阅者及店铺设置
  • 获取销售报表并查看近期订单
适用场景
适合经营 NanoCart 店铺、希望在支持 MCP 的 AI 助手中用对话方式处理商品上架、订单状态、优惠券和销售数据，而不必登录后台的用户。
运行要求
需要一个 NanoCart 店铺，以及管理员 API 密钥（NANOCART_API_KEY，sc_live_ 前缀）和店铺 ID（NANOCART_STORE_ID）。可通过 npx nanocart-mcp 在本地运行（需 Node.js），也可使用托管 Streamable HTTP 端点，通过 Authorization bearer 头以及 URL 或 X-Store-Id 头提供店铺 ID。
安装前请注意
该 API 密钥拥有店铺的完整管理员权限，应像密码一样保管。工具会修改店铺数据：商品、订单、优惠券和设置可被创建、更新或归档，破坏性工具仅靠注解提示，客户端可能忽略。退款、账单和 API 密钥管理未开放。仅支持 OAuth 连接器的网页客户端无法发送 API 密钥头。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Nanocart Mcp，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.ByteBunny-io%2Fnanocart-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "nanocart": {
      "type": "http",
      "url": "https://mcp.nanocart.io/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

nanocart-mcp

Official NanoCart MCP server — run your store from any MCP-capable AI agent (Claude Code, Claude Desktop, Cursor, Codex, and friends). List and update products (with variants and images), manage orders, coupons, categories, subscribers and settings, and pull sales reports — by asking.

39 tools. Reads are marked read-only; destructive tools (archive product, delete coupon) are annotated so your agent asks before acting. Refunds, billing changes, and API-key management are deliberately NOT exposed — do those in your dashboard.

Credentials

From your dashboard: Settings → API Keys (sc_live_..., keep secret) and Settings → Store Information (your store ID). The key grants full admin access to your store — treat it like a password.

Option A — Local (recommended)

Claude Code:

bash
claude mcp add nanocart --env NANOCART_API_KEY=sc_live_... --env NANOCART_STORE_ID=your-store-id -- npx -y nanocart-mcp

Any client that speaks stdio MCP (JSON config style):

json
{  "mcpServers": {    "nanocart": {      "command": "npx",      "args": ["-y", "nanocart-mcp"],      "env": {        "NANOCART_API_KEY": "sc_live_...",        "NANOCART_STORE_ID": "your-store-id"      }    }  }}

Option B — Hosted (no install)

Endpoint: https://mcp.nanocart.io/mcp?store=your-store-id with header Authorization: Bearer sc_live_... (Streamable HTTP).

Claude Code:

bash
claude mcp add nanocart --transport http "https://mcp.nanocart.io/mcp?store=your-store-id" --header "Authorization: Bearer sc_live_..."

Note: web clients that only support OAuth-based custom connectors (e.g. claude.ai's connector UI) can't send API-key headers yet — use Option A there.

Example prompts

  • "List my draft products and publish the ones with images"
  • "Create a SUMMER20 coupon — 20% off, min order $50, expires end of August"
  • "What did I sell last week? Any orders I still need to ship?"
  • "Mark order NCT-1042 shipped with tracking 9400 1000 0000 0000 0000 00"
  • "Upload the photos in ./shots and create products from them at $24 each"

Safety

  • Secrets are redacted from every response; your key is never echoed or logged.
  • Destructive tools carry MCP destructiveHint annotations — well-behaved clients prompt before running them.
  • Prices are explicit price_cents integers (no dollars/cents ambiguity).

Pairs with the NanoCart skill (integration knowledge for building the cart into websites). Docs: https://docs.nanocart.io/#ai-build · AI-readable: https://docs.nanocart.io/llms-full.txt

MIT · © 2026 NanoCart · a ByteBunny, LLC company

来源：README.md，提交 c967982

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

1
  1. v1.2.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分