电商API集成服务器

Tienda Nube MCP Server是一个用于与Tienda Nube/Nuvemshop API集成的服务器,提供产品、订单、客户、类别、优惠券和Webhooks的全面管理功能。

  • by PedroHSGuimaraes
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 PedroHSGuimaraes/--NuvemShop-mcp-server

使用说明

云存储MCP服务器

MCP(模型上下文协议)服务器,用于集成 Cloud Store/Nuvemshop API。

此服务器展示了涵盖 API v1 主要功能的 MCP 工具:

  • 身份验证和商店信息: tiendanube_get_store_info
  • 产品:列出,搜索,获取,创建,更新,删除
  • 请求:列出,获取,创建,更新,取消,履行
  • 客户端:列出,搜索,获取,创建,更新,删除
  • 分类: 列出, 获取, 创建, 更新, 删除
  • 优惠券:列出,获取,创建,更新,删除
  • Webhooks:列出,获取,创建,更新,删除

要求

  • Node.js 18+
  • 环境变量 :
    • TIENDANUBE_ACCESS_TOKEN (必填)
    • TIENDANUBE_STORE_ID (必填)

安装

  • 安装依赖关系 : npm install
  • 编译工程 : npm run build

执行

  • 标准 MCP : npm start
  • HTTP 实用程序 : npm run start:http (健康终点) /health)

MCP 客户端配置 将 MCP 客户端(例如 Claude Desktop)添加到指向二进制或 node dist/index.js.

可用工具 通过 MCP (ListTools) 列出工具。服务器记录了超过35个工具,涵盖:

  • tiendanube_*product*
  • tiendanube_*order*
  • tiendanube_*customer*
  • tiendanube_*category*
  • tiendanube_*coupon*
  • tiendanube_*webhook*

美国雇主(MCP呼叫工具)

  • 获取商店信息: tiendanube_get_store_info
  • 产品列表: tiendanube_list_products (可选参数 : page, per_page, language, q等等)
  • 创建产品: tiendanube_create_product (支持多语言字段和变体)
  • 订单列表 : tiendanube_list_orders (按状态,付款,日期过滤)
  • 创建请求 : tiendanube_create_order (客户,项目,地址)
  • 管理 Webhooks : tiendanube_list_webhooks | tiendanube_create_webhook | tiendanube_update_webhook | tiendanube_delete_webhook

重要说明

  • 速率限制和备份:客户端将重试设置为 429/5xx。
  • 安全序列化:响应被清理为JSON。
  • 多语言:支持多个字段 es, pt, en.

问题和下一步 如果您需要官方文档中的额外功能(例如,用于产品有效负载外的变体或图像的专用操作),请在此处打开问题或要求我添加相应的 MCP 工具。