Terminal.shop MCP

终端.shop MCP服务器

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

](https://mseep.ai/app/pashaydev-terminal-shop-mcp)

特性

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

设置

先决条件

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

安装

1. 克隆此存储库

1. 安装依赖项：

   npm install

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

   ssh terminal.shop -t tokens

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

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

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

1. 请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许可证获得许可-有关详细信息，请参阅许可证文件。