AI导哈

电商服务终端

Terminal.shop MCP Server是一个为AI助手设计的电商服务终端，提供产品浏览、购物车管理、订单处理、订阅管理等核心功能，适用于在线购物场景。

  • by pashaydev
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 pashaydev/terminal.shop.mcp

使用说明

终端.shop MCP服务器

这个项目实现了一个mcp服务器，用于与terminal.shop交互。它允许ai助手通过Terminal.shop的API无缝浏览产品、管理购物车、下订单和处理订阅。

特性

  • 产品管理：浏览和搜索Terminal.shop的咖啡产品
  • 购物车操作：将商品添加到购物车，设置收货地址和付款方式
  • 订单管理：下订单并查看订单历史记录
  • 订阅处理：创建和管理定期咖啡订阅
  • 用户档案：更新用户信息并管理送货地址
  • 付款方式：安全处理付款信息

设置

先决条件

  • Node.js
  • Terminal.shop帐户
  • Terminal.shop API令牌

安装

  1. 克隆此存储库

  2. 安装依赖项：

    npm install

  3. 连接到Terminal.shop并创建新令牌：

    ssh terminal.shop -t tokens

  4. 打开claude.app，转到设置，单击“开发人员”选项和“编辑配置”：

{
  "mcpServers": {
    "terminal-shop-mcp": {
      "command": "node",
      "args": ["path_to_folder/server.js"],
      "env": {
        "TERMINAL_API_TOKEN": "token here"
      }
    }
  }
}

  1. 重新启动claude.app，并确保在输入下看到锤子图标

  2. 请claude获取产品列表或创建新地址、订阅等

可用资源

MCP服务器提供以下资源：

  • terminal://products -列出所有可用产品
  • terminal://product/{id} -获取特定产品的详细信息
  • terminal://orders -查看订单历史记录
  • terminal://profile -访问用户配置文件信息
  • terminal://addresses -管理收货地址
  • terminal://cards -管理付款方式
  • terminal://cart -查看当前购物车
  • terminal://subscriptions -管理咖啡订阅

工具

服务器提供了各种与Terminal.shop交互的工具：

产品工具

  • search-products -按关键字搜索产品
  • get-product-details -获取特定产品的详细信息

购物车工具

  • add-to-cart -将产品变体添加到购物车
  • set-cart-address -设置购物车的送货地址
  • set-cart-card -设置购物车的付款方式
  • clear-cart -清空购物车
  • checkout -将购物车转换为订单

订购工具

  • create-order -不使用购物车直接创建订单

用户管理工具

  • update-profile -更新用户配置文件信息
  • create-address -添加新的收货地址
  • delete-address -删除收货地址
  • collect-card -生成用于添加付款信息的安全URL
  • create-card -使用Stripe令牌添加卡
  • delete-card -删除付款方式

订阅工具

  • create-subscription -开始新的咖啡订阅
  • cancel-subscription -取消现有订阅

帐户工具

  • create-token -创建新的个人访问令牌
  • delete-token -删除个人访问令牌
  • get-app-data -一次获取所有帐户数据

提示模板

该服务器包括几个提示模板，以帮助AI助手提供更好的响应：

  • browse-products -浏览和查找产品指南
  • manage-cart -帮助管理购物车
  • place-order -协助下单
  • manage-subscription -支持订阅管理
  • manage-profile -个人资料和地址管理指南

API文档

此MCP服务器构建在Terminal.shop API之上。有关基本API的详细信息，请参阅终端API文档。

安全考虑

  • 服务器通过安全的URL处理敏感的支付信息，而不是直接处理卡详细信息
  • API令牌存储在环境变量中以防止暴露
  • 用户数据根据Terminal.shop的安全实践进行处理

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP