Terminal.shop MCP 服务器

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

特征

• 产品管理：浏览和搜索 Terminal.shop 的咖啡产品

• 购物车操作：将商品添加到购物车，设置送货地址和付款方式

• 订单管理：下订单并查看订单历史记录

• 订阅处理：创建和管理定期咖啡订阅

• 用户资料：更新用户信息并管理送货地址

• 付款方式：安全处理付款信息

Related MCP server: Command-Line MCP Server

设置

先决条件

• Node.js

• Terminal.shop 帐户

• Terminal.shop API 令牌

安装

1. 克隆此存储库

2. 安装依赖项：

   npm install

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

   ssh terminal.shop -t tokens

4. 打开 claude.app，进入设置，点击“开发者”选项和“编辑配置”：

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

7. 要求克劳德获取产品列表或创建新地址、订阅等

可用资源

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 文件。