Terminal.shop MCP Server

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 を開き、設定に移動して、「開発者」オプションと「構成の編集」をクリックします。

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 - 新しい配送先住所を追加する
• delete-address - 配送先住所を削除する
• collect-card - 支払い情報を追加するための安全なURLを生成する
• create-card - Stripeトークンを使用してカードを追加する
• delete-card - 支払い方法の削除

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

• create-subscription - 新しいコーヒーのサブスクリプションを開始する
• cancel-subscription - 既存のサブスクリプションをキャンセルする

アカウントツール

• create-token - 新しい個人アクセストークンを作成する
• delete-token - 個人アクセストークンを削除する
• get-app-data - すべてのアカウントデータを一度に取得する

プロンプトテンプレート

サーバーには、AI アシスタントがより良い応答を提供できるようにするためのプロンプト テンプレートがいくつか含まれています。

• browse-products - 商品の閲覧と検索ガイド
• manage-cart - ショッピングカートの管理に関するヘルプ
• place-order - 注文のサポート
• manage-subscription - サブスクリプション管理のサポート
• manage-profile - プロフィールとアドレス管理のガイド

APIドキュメント

このMCPサーバーはTerminal.shop APIをベースに構築されています。基盤となるAPIの詳細については、Terminal APIドキュメントをご覧ください。

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

• サーバーは、カードの詳細を直接処理するのではなく、安全なURLを通じて機密の支払い情報を処理します。
• APIトークンは露出を防ぐために環境変数に保存されます
• ユーザーデータはTerminal.shopのセキュリティ対策に従って処理されます

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。