Gotas Commerce MCP Server

Интеграция API Drops Commerce и MCP

Надежное решение для интеграции криптовалютных платежей с использованием протокола MCP (Model Context Protocol), позволяющее помощникам на основе искусственного интеллекта, таким как Клод, создавать и проверять транзакции USDT через API Gotas Commerce.

🚀 Обзор

Этот проект является связующим звеном между помощниками на базе искусственного интеллекта и сервисами криптовалютных платежей. Благодаря внедрению сервера MCP помощники могут генерировать платежные ссылки, проверять статус транзакций и получать подробную информацию о платежах USDT, не требуя при этом специальных технических знаний в области блокчейна.

✨ Ресурсы

Инструменты МКП

create-payment

Создает новую платежную транзакцию USDT и возвращает все необходимые данные, включая URL-адрес платежа и адрес кошелька.

Параметры:

• amount : Сумма платежа (например: 100,50)
• currency : Код валюты (в настоящее время просто «USDT»)
• return_url : URL для перенаправления клиента после оплаты
• description : Необязательное описание платежа

Возвращаться:

• Полный объект JSON со всеми платежными реквизитами:
  • Уникальный идентификатор платежа
  • URL-адрес платежа
  • Адрес кошелька
  • Статус (ожидание, завершено, неудача, просрочен)
  • Даты создания и истечения срока действия
  • Другие соответствующие метаданные

check-payment-status

Он проверяет текущий статус существующего платежа по его уникальному идентификатору.

Параметры:

• payment_id : Уникальный идентификатор платежа, который необходимо проверить

Возвращаться:

• Полный объект JSON с текущим статусом платежа
• Информация о временной метке для создания, истечения срока действия и завершения (где применимо)
• Хэш транзакции блокчейна (при подтверждении платежа)

Ресурсы МКП

payment-status://{payment_id}

Он предоставляет форматированную и упрощенную версию статуса платежа в качестве ресурса MCP.

Возвращаться:

• Форматированный текст с наиболее актуальной платежной информацией
• Идентификатор, статус, значение, временные метки и описание

Подсказки MCP

create-payment-prompt

Пошаговая инструкция, помогающая пользователю предоставить информацию, необходимую для создания нового платежа.

🔧 Архитектура

Сервер MCP действует как уровень абстракции над API Drops Commerce, преобразуя возможности API в инструменты, ресурсы и подсказки, которые легко использовать помощникам на основе искусственного интеллекта, таким как Клод.

📋 Предварительные условия

• Python 3.8 или выше
• Ключ API Gotas Commerce (получить его можно на сайте: commerce.gotas.com )
• Доступ к помощнику, совместимому с MCP (например, Клоду)

🔌 Установка

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

Конечные точки API Drops Commerce :

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}

МКП-коммуникация

• Транспорт : SSE (события, отправленные сервером)
• Формат : JSON для связи между помощником и сервером MCP
• Аутентификация : ключ API хранится как переменная среды

📂 Структура проекта

🔒 Безопасность

• Ключ API хранится как переменная среды, а не в исходном коде.
• Связь с API Gotas Commerce осуществляется через HTTPS.
• Сервер MCP проверяет все параметры перед отправкой в API.
• Правильная обработка ошибок во избежание раскрытия конфиденциальной информации

🧩 Расширяемость

Проект спроектирован с возможностью легкого расширения:

1. Новые функции : добавление новых инструментов MCP, реализующих функции, декорированные @mcp.tool() на сервере.
2. Интеграция с другими сервисами : Архитектура позволяет легко интегрировать другие сервисы помимо Gotas Commerce.
3. Поддержка новых монет : платформа готова поддерживать другие криптовалюты помимо USDT в будущем.

📚 Примеры использования

Создание платежа (через Клода)

Проверка статуса (через Клода)

📞 Поддержка и контакты

Для получения поддержки или дополнительной информации свяжитесь с командой разработчиков Gotas или создайте проблему в репозитории GitHub.

📜 Лицензия

Лицензия Массачусетского технологического института