Boxzooka MCP 服务器

将 Boxzooka bxz-api（Product、Inbound、Order、Inventory、Shipment、Return）封装为 MCP 服务器，与 Materials Inventory 连接器采用相同模式：一个共享服务器、一对共享凭据，整个团队连接到同一个 URL。

共 33 个工具，覆盖完整的读写操作。EDI 不在覆盖范围内——它基于 XML，Boxzooka 需要与其 IT 团队单独沟通配置；如果你确实需要，告诉我，我会加上。

文件

• boxzooka_mcp.py — 服务器

• requirements.txt — Python 依赖

• Dockerfile — 用于远程托管的容器构建

Related MCP server: MoySklad MCP Server

1. 部署（与 Materials Inventory 分开的服务）

这是与 Materials Inventory 连接器分开的独立部署——每个服务器都需要自己的 Railway/Render/Fly 服务。

1. 将这三个文件推送到一个新仓库（或现有仓库中的文件夹）。

2. Railway → 新建项目 → 从 GitHub 仓库部署 → 选择它。

3. 在 变量 中添加：

   • BOXZOOKA_API_TOKEN = 你的沙盒令牌（c44f966f5c7fc4cdb7d7f461ab4414c6）

   • BOXZOOKA_CUSTOMER_ID = 242

   • BOXZOOKA_API_BASE_URL = https://api.boxzooka.com，用于生产环境（实时仓库数据）。如果省略，则默认为沙盒环境（https://sandbox.boxzooka.com），其中是静态测试数据，不会反映实时发货——要获取真实数据，请设置生产环境 URL。注意：生产环境可能需要与沙盒不同的令牌/客户 ID；如果切换后调用返回 401，请向 Boxzooka 获取正式凭据。

4. Railway 会给你一个公共 URL，例如 https://boxzooka-production-xxxx.up.railway.app。

5. 提供给团队的连接器 URL 是该 URL 加上 /mcp：https://boxzooka-production-xxxx.up.railway.app/mcp

2. 连接团队

与 Materials Inventory 相同：每位团队成员在自己的 Claude 应用中将其添加为自定义连接器，指向上述 URL。无需逐用户配置。

3. 安全与沙盒说明

• 此令牌/客户组合当前指向 Boxzooka 的沙盒环境（根据其文档："用于测试和调试目的"）。你通过它看到的数据是测试数据，不是你的真实仓库——这里的订单和库存不会反映 Boxzooka 实体仓库中实际发生的情况。当你准备好上线时，请联系 Boxzooka 获取生产环境凭据，并通过 BOXZOOKA_API_TOKEN / BOXZOOKA_CUSTOMER_ID / BOXZOOKA_API_BASE_URL 进行设置。

• 与 Materials Inventory 相同的访问级别说明：此连接器可以创建订单、取消订单、调整退货等——完整的读写权限。不要在团队之外分享该 URL。

4. 覆盖范围

• Product：创建、按 SKU 获取、更新、列出全部、列出（分页）

• Inbound：创建、按 PO 编号获取、按日期范围搜索、按日期获取收货（实时）、更新、按日期分页收货

• Order：创建、取消、搜索（按 order_id/order_key/external_id）、更新、按日期加载 WMS 订单

• Inventory：列出全部库存、按 SKU 获取、今日调整、按日期调整、按日期上架，以及每种的分页变体

• Shipment：按订单键获取、按日期范围获取、按日期分页

• Return：搜索、按日期搜索、创建、更新、取消

未覆盖：EDI（基于 XML，需要与 Boxzooka IT 团队单独沟通）。