Terminal.shop

🚀 終端商店MCP服務器

本項目實現了一個能夠與Terminal.shop進行交互的MCP服務器。藉助Terminal.shop的API，它能讓AI助手流暢地完成產品瀏覽、購物車管理、訂單下達以及訂閱處理等操作。

🚀 快速開始

此MCP服務器可助力AI助手與Terminal.shop無縫交互。你可以按以下步驟進行操作：

1. 完成服務器的安裝與配置。
2. 重啟claude.app，確保看到輸入框下方的錘子圖標。
3. 要求claude獲取產品列表或創建新地址、訂閱等。

✨ 主要特性

• 產品管理：可對Terminal.shop的咖啡產品進行瀏覽和搜索。
• 購物車操作：能將商品添加到購物車，還可設置配送地址和支付方式。
• 訂單管理：可以下單並查看訂單歷史。
• 訂閱處理：能夠創建和管理咖啡訂閱。
• 用戶資料：可更新用戶信息並管理配送地址。
• 支付方式：能安全地處理支付信息。

📦 安裝指南

先決條件

• Node.js
• Terminal.shop賬戶
• Terminal.shop API令牌

安裝步驟

1. 克隆此倉庫。
2. 安裝依賴：

   npm install
   

3. 連接到Terminal.shop並創建新的令牌：

   ssh terminal.shop -t tokens
   

4. 打開claude.app，進入設置，點擊“開發者”選項然後“編輯配置”：

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

6. 重啟claude.app，確保看到輸入框下方的錘子圖標。
7. 要求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許可證。