Terminal.shop MCP サーバー
このプロジェクトは、terminal.shopと連携するためのMCPサーバーを実装します。これにより、AIアシスタントはTerminal.shopのAPIを介して、商品の閲覧、ショッピングカートの管理、注文の確定、サブスクリプションの登録などをシームレスに行うことができます。
特徴
製品管理: Terminal.shop のコーヒー製品を閲覧および検索する
カート操作: 商品をカートに追加し、配送先住所と支払い方法を設定します
注文管理: 注文を出し、注文履歴を表示します
定期購入の取り扱い: 定期的なコーヒーの定期購入の作成と管理
ユーザープロフィール: ユーザー情報を更新し、配送先住所を管理します
支払い方法：支払い情報の安全な取り扱い
Related MCP server: Command-Line MCP Server
設定
前提条件
Node.js
Terminal.shopアカウント
Terminal.shop APIトークン
インストール
このリポジトリをクローンする
依存関係をインストールします:
npm installTerminal.shop に接続し、新しいトークンを作成します。
ssh terminal.shop -t tokensclaude.app を開き、設定に移動して、「開発者」オプションと「構成の編集」をクリックします。
claude.appを再起動し、入力欄にハンマーアイコンが表示されていることを確認します。
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 ファイルを参照してください。