电商平台API服务器

MCP Server是一个用于与Magalu Marketplace API集成的服务器,提供产品管理、订单处理、客户服务和聊天功能。

  • by suissa
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 suissa/magalu-mcp-server

使用说明

MCP服务器-Magalu市场

用于与Magalu Marketplace API集成的模型上下文协议(MCP)服务器。

功能

此服务器可访问以下 Magalu API:

📦 产品组合(Portfolio)

  • 列出、创建和更新 SKU
  • 管理产品价格
  • 库存控制
  • 查看优化分数

📋 订单

  • 列出和查看订单
  • 管理交付
  • 查看税务报表

🎫 战略空军司令部

  • 列出和管理服务票

❓ 问题和答案

  • 列出客户问题
  • 回答有关产品的问题

💬 与客户聊天

  • 管理对话
  • 发送消息

安装

cd Magalu/mcp-server
npm install
npm run build

配置

设置环境变量 :

export MAGALU_API_KEY="sua_api_key"
export MAGALU_SELLER_ID="seu_seller_id"
export MAGALU_ENV="sandbox"  # ou "production"

与 Kiro 一起使用

添加到您的文件 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "magalu": {
      "command": "node",
      "args": ["C:/caminho/para/Magalu/mcp-server/dist/index.js"],
      "env": {
        "MAGALU_API_KEY": "sua_api_key",
        "MAGALU_SELLER_ID": "seu_seller_id",
        "MAGALU_ENV": "sandbox"
      }
    }
  }
}

可用工具

产品

  • list_skus - 产品组合SKU列表
  • get_sku - 获取SKU的详细信息
  • create_sku 创建新 SKU
  • update_sku 更新现有SKU
  • get_sku_price - 查询价格
  • update_sku_price - 价格更新
  • get_sku_stock - 查询库存
  • update_sku_stock - 更新库存
  • get_sku_score - 查询优化分数

订单

  • list_orders - 订单列表
  • get_order - 获取订单详情
  • get_order_delivery -咨询交付
  • update_order_delivery - 更新交付
  • get_order_invoice -税务咨询说明

战略空军司令部

  • list_tickets -Lista门票
  • get_ticket 获取门票详情
  • update_ticket 更新门票

问题

  • list_questions - 问题清单
  • get_question - 获取问题详情
  • answer_question - 回答问题

聊天

  • list_conversations - 对话列表
  • get_conversation - 获取对话详细信息
  • send_message - 发送消息

埃斯科波斯OAuth2

要使用 API,您需要以下范围:

产品

  • open:portfolio-skus-seller:read
  • open:portfolio-skus-seller:write
  • open:portfolio-prices-seller:read
  • open:portfolio-prices-seller:write
  • open:portfolio-stocks-seller:read
  • open:portfolio-stocks-seller:write
  • open:portfolio-scores-seller:read

订单

  • open:order-order-seller:read
  • open:order-delivery-seller:read
  • open:order-delivery-seller:write
  • open:order-logistics-seller:read
  • open:order-logistics-seller:write
  • open:order-invoice-seller:read

官方文件

欲了解更多信息,请参阅 Magalu官方文件.

许可证

麻省理工学院