ScanPower MCP 服务器

一个模型上下文协议（MCP）服务器，为亚马逊FBA和电子商务操作提供访问ScanPower API的权限。

概述

这个MCP服务器使您能够通过MCP兼容的客户端与ScanPower API进行交互。ScanPower是一个平台，帮助卖家和第三方物流（3PL）管理亚马逊FBA操作、采购订单、出库装运、商品/箱子/托盘标签以及目录操作。

特点/功能

灵活认证支持自动认证和手动API令牌传递
令牌管理当未提供令牌时自动检索，同时支持可选的手动令牌传递
亚马逊SP-API集成通过ScanPower访问亚马逊的销售伙伴API
FBA运营管理入库货物、包装选项和库存
预准备计费（或：预账单准备）管理准备矩阵、价格层级和计费
目录操作搜索和管理亚马逊商品目录项
用户管理访问用户帐户和代理用户功能

安装

克隆或下载此仓库

安装依赖项：

   npm install

构建项目：

   npm run build

配置

复制示例环境文件：

   cp .env.example .env

编辑 .env 使用您的ScanPower凭据：

   # ScanPower API Configuration
   SCANPOWER_BASE_URL=https://api.scanpower.com
   SCANPOWER_OPENAPI_SPEC=https://unity.scanpower.com/docs/api/scanpower-api-bundled.json

   SCANPOWER_USERNAME=your_username
   SCANPOWER_PASSWORD=your_password

   # Optional: Proxy user ID for making calls on behalf of another user
   SCANPOWER_PROXY_USER_ID=

   # Amazon SP-API Configuration (for Amazon-specific operations)
   AMAZON_MARKETPLACE_ID=ATVPDKIKX0DER
   AMAZON_ACCESS_KEY_ID=your_access_key
   AMAZON_SECRET_ACCESS_KEY=your_secret_key
   AMAZON_ROLE_ARN=your_role_arn

使用方法

运行服务器

npm start

或者用于开发：

npm run dev

可用工具

服务器提供以下MCP工具：

身份验证与用户管理

getUsers获取活跃用户列表（包括主用户和子用户）
getProxyUsers获取客户端代理用户的列表
getApiToken所有其他API调用都需要此端点提供的令牌
getAccessToken从亚马逊获取访问令牌，以便使用SP-API进行调用

目录操作

searchCatalogItems搜索目录项
catalogSearch目录搜索

FBA入库操作

listInboundPlans列出入站计划
createInboundPlan创建入库计划
getInboundPlan获取入站计划
listInboundPlanBoxes列出入库计划箱
cancelInboundPlan取消入境计划
listInboundPlanItems列出InboundPlan项目
updateInboundPlanName更新入库计划名称
listPackingGroupBoxes列出包装组箱子
listPackingGroupItems列出装箱组项目
setPackingInformation设置包装信息
listPackingOptions列出打包选项
generatePackingOptions生成包装选项
confirmPackingOption确认包装选项
listInboundPlanPallets列出入库计划托盘
listPlacementOptions列出放置选项
generatePlacementOptions生成布局选项
confirmPlacementOption确认放置选项

装运操作

getShipment获取货物/装运
listShipmentBoxes列出装运箱
listShipmentContentUpdatePreviews列出装运内容更新预览
generateShipmentContentUpdatePreviews生成装运内容更新预览
getShipmentContentUpdatePreview获取装运内容更新预览
confirmShipmentContentUpdatePreview确认发货内容更新预览
getDeliveryChallanDocument获取交货单（Delivery Challan）文件
listDeliveryWindowOptions列出配送时间窗口选项
generateDeliveryWindowOptions生成送货时间选项
confirmDeliveryWindowOptions确认交付窗口选项
listShipmentItems列出装运项目
updateShipmentName更新装运名称
listShipmentPallets列出装运托盘
cancelSelfShipAppointment取消SelfShip预约
getSelfShipAppointmentSlots获取SelfShip预约时段
generateSelfShipAppointmentSlots生成SelfShip预约时段
scheduleSelfShipAppointment安排SelfShip预约
updateShipmentSourceAddress更新发货来源地址
updateShipmentTrackingDetails更新货物追踪详情
listTransportationOptions列出交通方式选项
generateTransportationOptions生成交通方案
confirmTransportationOptions确认运输方式

合规与准备工作运营

listItemComplianceDetails列表项合规详情
updateItemComplianceDetails更新项目合规详情
createMarketplaceItemLabels创建市场物品标签
listPrepDetails列表准备详情
setPrepDetails设置准备详情
getInboundOperationStatus获取入站操作状态
getBillOfLading获取提单
getLabels获取标签

库存与批次操作

getInboundPlans获取入站计划
createInboundPlanFromBatch根据提供的批次中的项目创建一个入库计划
submitBoxes提交框
scoutSearch封装多个SP-API调用以加载产品、报价和定价数据的包装器
selectBoxes用于Amazon v1批次的列表框
insertBox插入一个框
deleteBox删除一个框
selectBox获取一个盒子
updateBox删除框
selectBoxItems列表框项目
insertBoxItem插入框项目（BoxItem）
deleteBoxItem删除框项
updateBoxItem更新 BoxItem
selectInventory选择库存
selectPallets列出托盘
insertPallet插入托盘
getMobileInventory从数据库中返回按条件分组的找到的库存数量和购买列表数量
deletePallet删除托盘
selectPallet托盘列表
updatePallet更新托盘

采购订单

PurchaseOrders获取采购订单列表
CreatePurchaseOrder创建一个单一的采购订单
UpdatePurchaseOrder更新采购订单。此操作不会更改采购订单中的任何项目
PurchaseOrderItems获取采购订单项目的列表
CreatePurchaseOrderItems向采购订单中添加项目
UpdatePurchaseOrderItem更新单个采购订单项

批处理操作

Batches获取批次
CreateBatch创建批处理
UpdateBatch批量更新
BatchItems获取批处理项
CreateBatchItems创建批次项目
UpdateBatchItemGql更新批次项
ImportPurchaseOrderItems导入采购订单项
Buylist获取购书清单项目
Inventory获取库存
UpdateInventoryItems更新库存项目
createBuylist创建采购清单项目
getPackHistory获取包历史记录

沃尔玛运营

getWmAccessToken获取沃尔玛访问令牌
itemSetupByMatch通过匹配获取项目设置
bulkInventoryUpdate批量库存更新
allFeedStatuses获取所有Feed状态
retireAnItem移除库存项目
itemLabel生成项目标签
selectBatches列出批次
insertBatches插入批次
selectBatch按ID获取沃尔玛批次信息
updateBatches更新批次
deleteBatches删除批次
selectBatchItems列出批次项目
insertBatchItems插入批次项目
updateBatchItems更新批次项
updateBatchItem更新批次项目
deleteBatchItems删除批量项目
getInboundShipments获取入库货物（或：获取入站货物）
createInboundShipment创建入库单
fetchInboundPreview获取入站预览
updateShipmentQuantities更新装运数量
updateWmShipmentTrackingDetails更新沃尔玛发货追踪详情
createCarrierRateQuote创建承运商费率报价
selectWmShipments从数据库中选择沃尔玛发货单
selectWmShipment通过ID选择单个沃尔玛发货单
selectWmBoxes从数据库中选择沃尔玛箱子
insertWmBoxes将沃尔玛的箱子信息录入我们的数据库
updateWmBoxes将沃尔玛的箱子信息更新到我们的数据库中
selectWmBox按ID选择一个单独的沃尔玛盒子
deleteWmBoxes通过ID删除一个或多个沃尔玛盒子
createInboundShipmentLabel创建入库货件标签
printCarrierLabel打印沃尔玛承运商标签
getInboundShipmentErrors获取入库货件错误信息
getInboundShipmentItems获取入库货物项目
cancelInboundShipment取消入境货物运输

准备矩阵与计费

selectPrepMatrixProducts获取所有预处理矩阵产品映射
insertPrepMatrixProducts创建多个预处理矩阵产品映射
selectPrepMatrixProduct通过外部ID获取特定的预处理矩阵产品映射
updatePrepMatrixProducts根据外部ID更新预处理矩阵产品映射
deletePrepMatrixProducts通过external_id删除一个或多个预处理矩阵产品映射
selectPrepMatrices获取所有准备类型
insertPrepMatrices创建多个预处理类型矩阵
prepCenterBillingReport获取指定时间段的账单报告
prepCenterBillingReportPost获取指定时间段的账单报告
selectShipmentPrepMatrices获取按装运批次的临时费用
selectShipmentPrepMatricesPost获取单据级别的临时费用
insertShipmentPrepMatrices添加一个或多个装运级别的临时费用
updateShipmentPrepMatrices更新或删除一个或多个装运级别的临时费用
selectPrepMatrix通过ID获取特定的预处理类型矩阵
updatePrepMatrices根据ID更新一个或多个预处理类型矩阵
deletePrepMatrices通过ID删除一个或多个预处理类型矩阵

Webhooks与承运商操作

selectWebHooks列出WebHooks
generateWebHookSecretKey生成WebHook密钥
testWebHook测试WebHook
updateWebHook更新WebHook
deleteWebHook删除WebHook
getCarrierRateQuote获取承运商费率报价
confirmCarrierRateQuote确认承运商费率报价
cancelCarrierRateQuote取消承运商费率报价

示例用法

搜索目录项

{
  "tool": "search_catalog_items",
  "arguments": {
    "keywords": "wireless headphones",
    "marketplace_ids": ["ATVPDKIKX0DER"],
    "page_size": 20
  }
}

使用API令牌（可选）

{
  "tool": "search_catalog_items",
  "arguments": {
    "keywords": "wireless headphones",
    "marketplace_ids": ["ATVPDKIKX0DER"],
    "page_size": 20,
    "api_token": "your_api_token_here"
  }
}

列出入境计划

{
  "tool": "list_inbound_plans",
  "arguments": {
    "page_size": 10
  }
}

获取入站计划详情

{
  "tool": "get_inbound_plan",
  "arguments": {
    "inbound_plan_id": "your-plan-id-here"
  }
}

错误处理

服务器包含对以下内容的全面错误处理：

身份验证失败
API速率限制
无效的参数
网络连接问题
亚马逊SP-API错误

所有错误均以标准化格式返回，并附带描述性错误信息。

发展

项目结构

scanpower-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── .env.example          # Environment variables template
└── README.md            # This file

建筑

npm run build

开发模式

npm run dev

观察变化

npm run watch

API 参考文档

这个MCP服务器基于ScanPower API v2.0规范。有关底层API端点及其参数的详细信息，请参阅 ScanPower API文档。

认证

服务器使用基本身份验证进行初始API访问，然后管理承载令牌以处理后续请求。Amazon SP-API操作需要额外的OAuth2风格身份验证，该过程会自动处理。

速率限制

服务器遵守ScanPower的速率限制策略。如果您遇到速率限制错误，服务器将返回相应的错误信息。

支持

对于以下相关问题：

ScanPower API联系 ScanPower 支持
这个MCP服务器在这个仓库中创建一个问题
MCP协议参考 MCP 文档

许可证

MIT 许可证 - 详情请参见 LICENSE 文件。

贡献

为仓库创建分支（或“克隆仓库”）
创建一个特性分支
进行你的更改
如适用，请添加测试
提交拉取请求

更改日志

v1.0.0

初次发布
支持核心ScanPower API操作
身份验证和令牌管理
亚马逊SP-API集成
全面的错误处理

ScanPower MCP Server

快速接入

详细介绍