Terminal.shop MCP Server

基本能力

产品定位

Terminal.shop MCP Server 是一个用于与 Terminal.shop 交互的 MCP 服务器，主要用于电子商务场景中的产品浏览、购物车管理、订单处理和订阅管理。

核心功能

• 产品管理：浏览和搜索 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 - 一次性获取所有账户数据

常见问题解答

• 如何获取 API 令牌？ 使用命令 ssh terminal.shop -t tokens 创建新的令牌。
• 如何配置 MCP 服务器？ 在 claude.app 的设置中，点击“开发者”选项并“编辑配置”，添加 MCP 服务器的详细信息。

使用教程

使用依赖

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

安装教程

1. 克隆仓库
2. 安装依赖： bash npm install
3. 连接到 Terminal.shop 并创建新令牌： bash ssh terminal.shop -t tokens
4. 在 claude.app 中，转到设置，点击“开发者”选项并“编辑配置”： json { "mcpServers": { "terminal-shop-mcp": { "command": "node", "args": ["path_to_folder/server.js"], "env": { "TERMINAL_API_TOKEN": "token here" } } } }
5. 重启 claude.app，确保输入框下方出现锤子图标
6. 让 Claude 获取产品列表或创建新地址、订阅等

调试方式

• 确保 Node.js 已正确安装
• 检查 API 令牌是否正确配置
• 重启 claude.app 并检查锤子图标是否出现
• 使用提供的工具命令进行测试，如 search-products 或 get-product-details

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。