コマースAPIとMCPの統合を廃止

MCP (モデル コンテキスト プロトコル) を使用した暗号通貨支払い統合のための堅牢なソリューション。これにより、Claude などの AI アシスタントが Gotas Commerce API を通じて USDT トランザクションを作成および検証できるようになります。

🚀 概要

このプロジェクトは、AI アシスタントと暗号通貨決済サービスの間に橋渡しをします。 MCP サーバーを実装すると、アシスタントはブロックチェーンの専門知識を必要とせずに、支払いリンクを生成し、取引ステータスを確認し、USDT 支払いに関する詳細情報を取得できるようになります。

Related MCP server: MCP Coinbase Commerce Server

✨ リソース

MCPツール

create-payment

新しい USDT 支払いトランザクションを作成し、支払い URL やウォレット アドレスなどの必要な詳細をすべて返します。

パラメータ:

• amount ：支払い金額（例：100.50）

• currency : 通貨コード（現在は「USDT」のみ）

• return_url : 支払い後に顧客をリダイレクトするURL

• description : 支払いの説明（オプション）

戻る：

• すべての支払い詳細を含む完全な JSON オブジェクト:

  • 固有の支払いID

  • 支払いURL

  • ウォレットアドレス

  • ステータス（保留中、完了、失敗、期限切れ）

  • 作成日と有効期限

  • その他の関連メタデータ

check-payment-status

固有の識別子を通じて、既存の支払いの現在のステータスを確認します。

パラメータ:

• payment_id : 検証する支払いの一意のID

戻る：

• 現在の支払いステータスを含む完全な JSON オブジェクト

• 作成、有効期限、完了のタイムスタンプ情報（該当する場合）

• ブロックチェーントランザクションハッシュ（支払いが確認されたとき）

MCPリソース

payment-status://{payment_id}

MCP リソースとして、支払いステータスのフォーマットされた簡略化されたバージョンを提供します。

戻る：

• 最も関連性の高い支払い情報を記載した書式設定されたテキスト

• 識別子、ステータス、値、タイムスタンプ、説明

MCPプロンプト

create-payment-prompt

新しい支払いを作成するために必要な情報をユーザーが提供できるようにするためのガイド付きプロンプト。

🔧 建築

MCP サーバーは Drops Commerce API の抽象化レイヤーとして機能し、API 機能を、Claude のような AI アシスタントが簡単に使用できるツール、リソース、プロンプトに変換します。

📋 前提条件

• Python 3.8以上

• Gotas Commerce API キー ( commerce.gotas.comで取得)

• MCP 対応アシスタント (Claude など) へのアクセス

🔌 インストール

1. このリポジトリをクローンします:

   git clone https://github.com/caiovicentino/mcpGOTAS.git cd mcpGOTAS

2. 依存関係をインストールします:

   pip install -r requirements.txt

   または、自動セットアップ スクリプトを使用します。

   ./setup.bat

3. 環境変数を設定します。

   • 次の値を持つ.envファイルを作成します。

     GOTAS_API_KEY=sua_chave_api_aqui GOTAS_BASE_URL=https://commerce.gotas.com

🏃‍♂️ 処刑

MCPサーバー

サーバーを実行して、MCP 経由でツールを利用できるようにします。

Claude Desktopとの統合

Claude Desktop で直接使用するには:

または、手動でインストールします。

直接 API の使用 (テスト スクリプト)

ウィザードを使用せずに直接テストする場合:

• 支払いの作成: python test_client.py

• ステータスを確認する: python check_payment.py

📊 支払いフロー

1. 支払いの初期化：

   • 係員はユーザーから金額やその他の支払い詳細を取得します。

   • ウィザードは必要なパラメータを使用してcreate-paymentツールを呼び出します。

   • Gotas Commerceで新しい支払いが作成されます

   • 支払いリンクがユーザーに返されます

2. 支払い手続き：

   • ユーザーは提供された支払いリンクにアクセスする

   • ユーザーは表示されたウォレットアドレスにUSDTを送金する

   • ゴタスコマースは取引を確認するためにブロックチェーンを監視する

3. ステータスチェック:

   • アシスタントはcheck-payment-status statusを呼び出すことで支払い状況を確認できます。

   • ステータスは、保留中、完了、期限切れ、または失敗のいずれかになります。

   • 支払いが確認されると、ブロックチェーンのトランザクションハッシュが利用可能になる。

🔍 技術仕様

APIの詳細

コマース API エンドポイントを削除します:

1. 支払いを作成する

   • POST /api/v1/payments

   • リクエスト本文:

     { "amount": "100.00", "currency": "USDT", "return_url": "https://exemplo.com/retorno", "description": "Descrição do pagamento" }

2. 支払い状況を確認する

   • GET /api/v1/payments/{payment_id}

MCPコミュニケーション

• トランスポート: SSE (サーバー送信イベント)

• フォーマット: アシスタントとMCPサーバー間の通信用のJSON

• 認証: APIキーは環境変数として保存されます

📂 プロジェクト構造

🔒 セキュリティ

• APIキーはソースコードではなく環境変数として保存されます

• Gotas Commerce APIとの通信はHTTPS経由で行われます

• MCPサーバーはAPIに送信する前にすべてのパラメータを検証します。

• 機密情報の漏洩を防ぐための適切なエラー処理

🧩 拡張性

このプロジェクトは簡単に拡張できるように設計されています。

1. 新機能: サーバー上で@mcp.tool()で装飾された関数を実装する新しいMCPツールを追加します。

2. 他のサービスとの統合: このアーキテクチャにより、Gotas Commerce以外の他のサービスを簡単に統合できます。

3. 新しいコインのサポート：フレームワークは将来的にUSDT以外の暗号通貨をサポートする準備ができています

📚 使用例

支払いの作成（Claude経由）

ステータスの確認（Claude経由）

📞 サポートとお問い合わせ

サポートまたは追加情報については、Gotas 開発チームに問い合わせるか、GitHub リポジトリで問題を開いてください。

📜 ライセンス

MITライセンス