Terminal.shop 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": "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的详细信息，请参阅Terminal API文档。

安全注意事项

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

许可证

本项目根据MIT许可证发布 - 详情请见LICENSE文件。