关键词

电商平台咖啡商品浏览购物车订单管理订阅服务

使用说明

项目简介

本项目是一个 MCP (Model Context Protocol) 服务器，它充当 AI 助手与 Terminal.shop 电商平台之间的桥梁。通过此服务器，AI 助手可以安全、便捷地访问 Terminal.shop 的商品信息、管理购物车、下订单以及处理订阅服务。

主要功能点

  • 商品浏览与搜索: AI 助手可以浏览 Terminal.shop 上的咖啡商品，并根据关键词进行搜索，帮助用户发现心仪的商品。
  • 购物车操作: 支持将商品添加到购物车，设置收货地址和支付方式，方便用户管理购物车和准备下单。
  • 订单管理: 用户可以通过 AI 助手查询订单历史，跟踪订单状态，实现订单管理。
  • 订阅服务: 支持咖啡订阅的创建和管理，用户可以方便地设置周期性咖啡订阅服务。
  • 用户资料管理: 允许用户更新个人资料和管理收货地址，提升用户体验。
  • 支付方式管理: 安全处理支付信息，支持用户管理支付方式。

安装步骤

  1. 克隆仓库 
    git clone https://github.com/pashaydev/terminal.shop.mcp.git
cd terminal.shop.mcp
  2. 安装依赖 
    npm install
  3. 获取 Terminal.shop API Token
    • 访问 Terminal.shop 并登录您的账户。
    • 通过 SSH 连接到 Terminal.shop 并创建新的 API Token： 
      ssh terminal.shop -t tokens
    • 复制生成的 API Token。

服务器配置

MCP 客户端（例如 Claude.app）需要配置此 MCP 服务器的启动信息。以下是配置示例，请将占位符替换为实际路径和 Token：

{
  "mcpServers": {
    "terminal-shop-mcp": {
      "command": "node",
      "args": ["/path/to/terminal.shop.mcp/server.js"],  // 将 "/path/to/terminal.shop.mcp" 替换为 server.js 文件所在的实际绝对路径
      "env": {
        "TERMINAL_API_TOKEN": "YOUR_TERMINAL_API_TOKEN"  // 将 "YOUR_TERMINAL_API_TOKEN" 替换为您在 Terminal.shop 获取的 API Token
      }
    }
  }
}

配置说明:

  • 'server name': 'terminal-shop-mcp' (服务器名称，客户端用此名称引用)
  • 'command': 'node' (运行 Node.js 代码的命令)
  • 'args': '["/path/to/terminal.shop.mcp/server.js"]' (启动服务器脚本 'server.js' 的路径，请务必替换为实际路径)
  • 'env': '{"TERMINAL_API_TOKEN": "YOUR_TERMINAL_API_TOKEN"}' (环境变量配置，用于传递 Terminal.shop API Token，请务必替换为您的 Token)

基本使用方法

  1. 启动 MCP 服务器: 配置完成后，MCP 客户端通常会自动启动或检测到 MCP 服务器。请参考您使用的 MCP 客户端的文档来了解如何启动和连接 MCP 服务器。对于 Claude.app，配置正确后，输入框下方会出现锤子图标，表示 MCP 服务器已连接。

  2. 与 AI 助手交互: 您可以通过 MCP 客户端与 AI 助手进行自然语言交互，指示 AI 助手使用 Terminal.shop MCP 服务器提供的功能。例如，您可以指示 AI 助手：

    • “浏览 Terminal.shop 上的咖啡商品”
    • “将某个商品添加到购物车”
    • “查询我的订单历史”
    • “创建一个新的咖啡订阅”
    • “更新我的收货地址”

AI 助手会根据您的指令调用相应的 MCP 工具或资源，并返回结果。

注意: 请确保您已在 Terminal.shop 拥有账户并获取有效的 API Token，并将配置信息正确填写到 MCP 客户端中。

信息

分类

商业系统

访问项目