Terminal.shop MCP 服务器

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

<a href="https://glama.ai/mcp/servers/@pashaydev/terminal.shop.mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@pashaydev/terminal.shop.mcp/badge" alt="Terminal.shop Server MCP server" /> </a>

功能特性

• 产品管理: 浏览和搜索 Terminal.shop 的咖啡产品
• 购物车操作: 添加商品到购物车，设置收货地址和支付方式
• 订单管理: 下订单和查看订单历史
• 订阅处理: 创建和管理周期性咖啡订阅
• 用户资料: 更新用户信息和管理收货地址
• 支付方式: 安全地处理支付信息

设置

前提条件

• Node.js
• 一个 Terminal.shop 账户
• 一个 Terminal.shop API 令牌

安装

1. 克隆此仓库

2. 安装依赖:

   npm install
   

3. 连接到 Terminal.shop 并创建一个新的令牌:

   ssh terminal.shop -t tokens
   

4. 打开 claude.app，进入设置，点击 'developer' 选项和 'edit config':

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

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 - 添加新的收货地址
• 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 文件。