コマースAPIとMCPの統合を廃止
MCP (モデル コンテキスト プロトコル) を使用した暗号通貨支払い統合のための堅牢なソリューション。これにより、Claude などの AI アシスタントが Gotas Commerce API を通じて USDT トランザクションを作成および検証できるようになります。
🚀 概要
このプロジェクトは、AI アシスタントと暗号通貨決済サービスの間に橋渡しをします。 MCP サーバーを実装すると、アシスタントはブロックチェーンの専門知識を必要とせずに、支払いリンクを生成し、取引ステータスを確認し、USDT 支払いに関する詳細情報を取得できるようになります。
✨ リソース
MCPツール
create-payment
新しい USDT 支払いトランザクションを作成し、支払い URL やウォレット アドレスなどの必要な詳細をすべて返します。
パラメータ:
amount ：支払い金額（例：100.50）currency : 通貨コード（現在は「USDT」のみ）return_url : 支払い後に顧客をリダイレクトするURLdescription : 支払いの説明（オプション）
戻る：
- すべての支払い詳細を含む完全な 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 アシスタントが簡単に使用できるツール、リソース、プロンプトに変換します。
┌────────────────┐ ┌───────────────┐ ┌──────────────────┐
│ │ │ │ │ │
│ Assistente IA ├────┤ Servidor MCP ├────┤ API Gotas │
│ (Claude) │ │ (FastAPI) │ │ Commerce │
│ │ │ │ │ │
└────────────────┘ └───────────────┘ └──────────────────┘
📋 前提条件
🔌 インストール
- このリポジトリをクローンします:
git clone https://github.com/caiovicentino/mcpGOTAS.git
cd mcpGOTAS
- 依存関係をインストールします:
pip install -r requirements.txt
- 環境変数を設定します。
- 次の値を持つ
.envファイルを作成します。GOTAS_API_KEY=sua_chave_api_aqui
GOTAS_BASE_URL=https://commerce.gotas.com
🏃♂️ 処刑
MCPサーバー
サーバーを実行して、MCP 経由でツールを利用できるようにします。
uvicorn src.gotas_mcp_server:app --host 0.0.0.0 --port 8000
Claude Desktopとの統合
Claude Desktop で直接使用するには:
または、手動でインストールします。
mcp install src.gotas_mcp_server.py
直接 API の使用 (テスト スクリプト)
ウィザードを使用せずに直接テストする場合:
- 支払いの作成:
python test_client.py - ステータスを確認する:
python check_payment.py
📊 支払いフロー
- 支払いの初期化：
- 係員はユーザーから金額やその他の支払い詳細を取得します。
- ウィザードは必要なパラメータを使用して
create-paymentツールを呼び出します。 - Gotas Commerceで新しい支払いが作成されます
- 支払いリンクがユーザーに返されます
- 支払い手続き：
- ユーザーは提供された支払いリンクにアクセスする
- ユーザーは表示されたウォレットアドレスにUSDTを送金する
- ゴタスコマースは取引を確認するためにブロックチェーンを監視する
- ステータスチェック:
- アシスタントは
check-payment-status statusを呼び出すことで支払い状況を確認できます。 - ステータスは、保留中、完了、期限切れ、または失敗のいずれかになります。
- 支払いが確認されると、ブロックチェーンのトランザクションハッシュが利用可能になる。
🔍 技術仕様
APIの詳細
コマース API エンドポイントを削除します:
- 支払いを作成する
POST /api/v1/payments- リクエスト本文:
{
"amount": "100.00",
"currency": "USDT",
"return_url": "https://exemplo.com/retorno",
"description": "Descrição do pagamento"
}
- 支払い状況を確認する
GET /api/v1/payments/{payment_id}
MCPコミュニケーション
- トランスポート: SSE (サーバー送信イベント)
- フォーマット: アシスタントとMCPサーバー間の通信用のJSON
- 認証: APIキーは環境変数として保存されます
📂 プロジェクト構造
├── src/
│ └── gotas_mcp_server.py # Implementação principal do servidor MCP
├── .env # Variáveis de ambiente (API key, etc.)
├── .smithery.json # Configuração para Smithery CLI
├── check_payment.py # Utilitário para verificar status de pagamentos
├── docsdaapigotas.md # Documentação detalhada da API
├── install_claude.py # Script para instalação no Claude Desktop
├── mcp.md # Documentação do servidor MCP
├── MCPPROTOCOLpython.MD # Documentação do protocolo MCP em Python
├── requirements.txt # Dependências do projeto
├── setup.bat # Script de configuração para Windows
├── smithery.json # Schema para integração com Smithery
└── test_client.py # Cliente de teste para criação de pagamentos
🔒 セキュリティ
- APIキーはソースコードではなく環境変数として保存されます
- Gotas Commerce APIとの通信はHTTPS経由で行われます
- MCPサーバーはAPIに送信する前にすべてのパラメータを検証します。
- 機密情報の漏洩を防ぐための適切なエラー処理
🧩 拡張性
このプロジェクトは簡単に拡張できるように設計されています。
- 新機能: サーバー上で
@mcp.tool()で装飾された関数を実装する新しいMCPツールを追加します。 - 他のサービスとの統合: このアーキテクチャにより、Gotas Commerce以外の他のサービスを簡単に統合できます。
- 新しいコインのサポート：フレームワークは将来的にUSDT以外の暗号通貨をサポートする準備ができています
📚 使用例
支払いの作成（Claude経由）
Usuário: Preciso gerar um link de pagamento de 50 USDT.
Claude: Vou gerar um link de pagamento para você. Para qual URL devo configurar o redirecionamento após o pagamento?
Usuário: https://meusite.com.br/obrigado
Claude: [Utilizando ferramenta create-payment]
Criando pagamento de 50 USDT com redirecionamento para https://meusite.com.br/obrigado...
Pronto! Criei um link de pagamento para 50 USDT.
Link de pagamento: [URL gerado pela API]
Este link expirará em 30 minutos. O cliente deve transferir exatamente 50 USDT para o endereço da carteira mostrado na página de pagamento.
ステータスの確認（Claude経由）
Usuário: Verifique o status do meu pagamento com ID xyz123.
Claude: [Utilizando ferramenta check-payment-status]
Verificando o status do pagamento ID xyz123...
O status atual do pagamento é: PENDENTE
- Valor: 50.00 USDT
- Criado em: [timestamp]
- Expira em: [timestamp]
O pagamento ainda não foi confirmado na blockchain. Você pode acompanhar usando o link de pagamento ou me pedir para verificar novamente mais tarde.
📞 サポートとお問い合わせ
サポートまたは追加情報については、Gotas 開発チームに問い合わせるか、GitHub リポジトリで問題を開いてください。
📜 ライセンス
MITライセンス