终端商店MCP服务器

此项目实现了一个与Terminal.shop交互的MCP服务器。它允许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": "令牌在此"
      }
    }
  }
}

6. 重启claude.app，确保看到输入框下方的锤子图标

7. 要求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 - 添加新的配送地址
• set-default-address - 设置默认配送地址
• remove-address - 删除配送地址

订阅工具

• subscribe - 创建新订阅
• get-subscriptions - 查看所有订阅
• cancel-subscription - 取消订阅
• update-subscription - 更新订阅信息
• add-payment-method - 添加新的支付方式到订阅
• remove-payment-method - 删除订阅中的支付方式

提示模板

• 产品提示：帮助用户查找特定产品或推荐热门产品。
• 购物车提示：指导用户管理购物车操作，如添加、删除商品。
• 订单提示：协助用户查看订单状态和历史记录。
• 订阅提示：提供关于订阅创建、更新和取消的指导。

API文档

完整的API文档可参考Terminal.shop开发者文档。

安全考虑

• 所有敏感信息（如API令牌）均需安全处理，避免泄露。
• 确保所有网络请求使用HTTPS以保证传输安全。
• 定期更新软件和依赖库，防范已知的安全漏洞。

许可证

该项目遵循MIT许可证。