Gotas Commerce MCP Server

Drops Commerce API 및 MCP 통합

MCP(모델 컨텍스트 프로토콜)를 사용하여 암호화폐 지불 통합을 위한 강력한 솔루션을 통해 Claude와 같은 AI 도우미가 Gotas Commerce API를 통해 USDT 거래를 생성하고 검증할 수 있습니다.

🚀 개요

이 프로젝트는 AI 비서와 암호화폐 지불 서비스를 연결하는 다리 역할을 합니다. MCP 서버를 구현하면 보조자는 전문적인 블록체인 기술 지식 없이도 결제 링크를 생성하고, 거래 상태를 확인하고, USDT 결제에 대한 자세한 정보를 얻을 수 있습니다.

✨ 리소스

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 도우미가 쉽게 사용할 수 있는 도구, 리소스 및 프롬프트로 변환합니다.

지엑스피1

📋 필수 조건

• 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를 전송합니다.
   • Gotas Commerce는 거래를 확인하기 위해 블록체인을 모니터링합니다.
3. 상태 확인 :
   • 보조자는 check-payment-status status를 호출하여 지불 상태를 확인할 수 있습니다.
   • 상태는 보류, 완료, 만료 또는 실패일 수 있습니다.
   • 결제가 확인되면 블록체인 거래 해시가 제공됩니다.

🔍 기술 사양

API 세부 정보

Drops Commerce 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 라이센스