🚀 终端商店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许可证。