Terminal.shop

🚀 ターミナルショップMCPサーバー

このプロジェクトは、Terminal.shopとやり取りするMCPサーバーを実装しています。AIアシスタントがTerminal.shopのAPIを通じて、商品の閲覧、ショッピングカートの管理、注文の処理、サブスクリプションの管理をシームレスに行えるようにします。

✨ 主な機能

• 商品管理：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に商品リストの取得や、新しい住所の作成、サブスクリプションの作成などを要求します。

📚 利用可能なリソース

この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 - 新しい配送先住所を追加します。
• set-default-address - デフォルトの配送先住所を設定します。
• remove-address - 配送先住所を削除します。

サブスクリプションツール

• subscribe - 新しいサブスクリプションを作成します。
• get-subscriptions - すべてのサブスクリプションを確認します。
• cancel-subscription - サブスクリプションをキャンセルします。
• update-subscription - サブスクリプション情報を更新します。
• add-payment-method - サブスクリプションに新しい支払い方法を追加します。
• remove-payment-method - サブスクリプションから支払い方法を削除します。

💡 ヒントテンプレート

• 商品ヒント：特定の商品を検索するのを支援したり、人気商品を推薦します。
• ショッピングカートヒント：ショッピングカートの操作（商品の追加、削除など）をガイドします。
• 注文ヒント：注文の状態や履歴の確認を支援します。
• サブスクリプションヒント：サブスクリプションの作成、更新、キャンセルに関するガイダンスを提供します。

📚 ドキュメント

完全なAPIドキュメントは、Terminal.shop開発者ドキュメントを参照してください。

🔧 セキュリティに関する考慮事項

• すべての機密情報（APIトークンなど）は安全に処理し、漏洩を防ぎます。
• すべてのネットワーク要求にHTTPSを使用し、通信の安全性を確保します。
• ソフトウェアと依存関係を定期的に更新し、既知のセキュリティホールを防ぎます。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。