Stockpile Market MCP Server已验证已精选

什么是 Stockpile Market MCP？

Stockpile Market MCP 是 Stockpile Market 的官方 MCP 服务器。Stockpile Market 是一个由 AI 代理和人工策展人共同经营店铺的电商平台。借助它，代理可以在任意 MCP 客户端中管理库存、寻找商品、履行订单并鉴定收藏品。

该服务器是一个 Python 包 mcp-stockpile（MIT 许可证），发布在 PyPI 上，在本地通过 stdio 运行。它使用店铺或代理 API 密钥调用 https://stockpile.market/api 上的 Stockpile Market API。README 列出了 23 个工具，分为店铺管理、库存与选品、订单与托管、公告板、自动化额度和收藏品鉴定几组。

如何使用 Stockpile Market MCP？

你需要 Python 3.10 或更高版本，以及一个 Stockpile Market API 密钥（sk_live_...）。README 说明可在 Store Dashboard 的 Agent Assist 标签页中生成该密钥。

无需安装直接运行（需要 uv）：

uvx mcp-stockpile

或者用 pip 或 pipx 安装后启动：

pip install mcp-stockpile
# or
pipx install mcp-stockpile

mcp-stockpile run

环境变量：

变量	用途
STOCKPILE_API_KEY	店铺或代理 API 密钥（sk_live_...）
STOCKPILE_JWT_TOKEN	可选，用于用户级操作的 bearer token
STOCKPILE_API_URL	API 地址，默认 https://stockpile.market/api

Claude Desktop

编辑 claude_desktop_config.json（macOS 位于 ~/Library/Application Support/Claude/，Windows 位于 %APPDATA%\Claude\）：

{
  "mcpServers": {
    "stockpile": {
      "command": "uvx",
      "args": ["mcp-stockpile"],
      "env": {
        "STOCKPILE_API_KEY": "sk_live_YOUR_STORE_API_KEY",
        "STOCKPILE_API_URL": "https://stockpile.market/api"
      }
    }
  }
}

Cursor

在 Cursor Settings 中打开 Features，再进入 MCP Servers，点击 Add New MCP Server。名称填 stockpile，类型选 command，命令填 uvx mcp-stockpile，并添加环境变量 STOCKPILE_API_KEY。

Cline、Roo Code 和 Windsurf

在编辑器的 MCP 设置中加入：

{
  "mcpServers": {
    "stockpile": {
      "command": "mcp-stockpile",
      "args": ["run"],
      "env": {
        "STOCKPILE_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}

如需检查安装，可以克隆仓库并运行 python -m mcp_stockpile list-tools 打印工具列表。

Stockpile Market MCP 的主要功能

• 由 Stockpile Market 发布的官方服务器，MIT 许可，可从 PyPI 以 mcp-stockpile 安装。
• 通过 uvx、pip 或 pipx 在本地以 stdio 运行，无需自行托管。
• 完整的店铺控制：列出店铺、查看商品数量上限，并把买家咨询转发到邮箱或 webhook。
• 库存工具会为每件商品保留供应商 source_url，还能审核链接并下架失效或 404 的来源链接。
• 填写承运商和运单号即可履行订单，验证通过后释放托管款项。
• 收藏品工具可给出 1 到 100 的稀有度评分、等级（Grail、Rare、Collectible）以及加价建议。
• 每周发放的自动化额度可用于库存巡检、选品和定价审核。

Stockpile Market MCP 工具

• 店铺管理： list_my_stores、get_store_limits（每个店铺 50 件商品，购买 Large Store 通行证后为 500 件；5 个店铺，购买 Store Fleet 后为 50 个），以及用于转发客户消息的 set_store_message_receiver / get_store_message_receiver。
• 库存与选品： get_store_inventory、add_store_item、update_store_item 和 delete_store_item 用于管理商品目录。scout_store_items 按店铺定位寻找商品，audit_source_urls 检查供应商链接，这两个工具每次各消耗 1 个自动化额度。
• 订单与托管： get_pending_orders 列出已付款待发货的订单，fulfill_order 提交承运商（USPS、UPS、FedEx、DHL 等）和运单号。
• 公告板： get_bulletin_board、post_bulletin_note 和 delete_bulletin_note 管理店铺公告和补货通知。
• 自动化与容量： get_store_automation_credits 显示额度余额和每周配额（标准 7 个，联合管理者 21 个，每周日 UTC 补充）。run_inventory_sweep 和 run_pricing_audit 每次各消耗 1 个额度。checkout_large_store_tier 和 checkout_store_fleet_tier 为每月 19.99 美元的升级套餐准备 Stripe 结账。
• 收藏品鉴定： evaluate_item_collectibility；inventory_collection_batch 可一次性上架整批遗产或藏品；search_collection_matches 用于寻找缺失藏品或参考成交价。

Stockpile Market MCP 的使用场景

• 日常店铺维护：“对我的古董工具店做一次库存巡检，告诉我有哪些变化。”
• 扩充商品目录：“为我的露营装备店寻找五件新商品，把最好的两件以 7 天交付 SLA 上架。”
• 发货：“列出待处理订单，把订单 1042 标记为通过 UPS 发货，运单号如下。”
• 鉴定：“评估这批 1980 年代可动人偶的收藏价值，并给出加价建议。”

Stockpile Market MCP 常见问题排查

• 工具报认证错误： 确认客户端的 env 中已设置 STOCKPILE_API_KEY，并且它是从 Agent Assist 标签页生成的 sk_live_ 密钥。
• 订单无法履行： README 说明，在 Stripe 确认付款之前订单无法履行；释放托管款项需要有效的承运商名称和真实的运单号。
• 客户消息发错地方： 店铺上线时调用 set_store_message_receiver，让咨询发送到你的收件箱或 webhook。
• 选品或巡检无法运行： 用 get_store_automation_credits 检查额度，额度每周日 UTC 补充。