JinDaGe - Terminal.shop MCP Details

article

README

🚀 终端商店MCP服务器

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

🚀 快速开始

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

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

✨ 主要特性

产品管理：可对Terminal.shop的咖啡产品进行浏览和搜索。
购物车操作：能将商品添加到购物车，还可设置配送地址和支付方式。
订单管理：可以下单并查看订单历史。
订阅处理：能够创建和管理咖啡订阅。
用户资料：可更新用户信息并管理配送地址。
支付方式：能安全地处理支付信息。

📦 安装指南

先决条件

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

安装步骤

克隆此仓库。
安装依赖：
```
npm install
```
连接到Terminal.shop并创建新的令牌：
```
ssh terminal.shop -t tokens
```
打开claude.app，进入设置，点击“开发者”选项然后“编辑配置”：

{
  "mcpServers": {
    "terminal-shop-mcp": {
      "command": "node",
      "args": ["path_to_folder/server.js"],
      "env": {
        "TERMINAL_API_TOKEN": "令牌在此"
      }
    }
  }
}

重启claude.app，确保看到输入框下方的锤子图标。
要求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许可证。

Terminal.shop