Terminal.shop

🚀 终端商店MCP服务器

本项目实现了一个能够与Terminal.shop进行交互的MCP服务器。借助Terminal.shop的API，它能让AI助手流畅地完成产品浏览、购物车管理、订单下达以及订阅处理等操作。

🚀 快速开始

此MCP服务器可助力AI助手与Terminal.shop无缝交互。你可以按以下步骤进行操作：

1. 完成服务器的安装与配置。
2. 重启claude.app，确保看到输入框下方的锤子图标。
3. 要求claude获取产品列表或创建新地址、订阅等。

✨ 主要特性

• 产品管理：可对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获取产品列表或创建新地址、订阅等。

💻 使用示例

基础用法

你可以使用以下资源与服务器进行交互：

• 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许可证。