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

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

🚀 Обзор

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

Related MCP server: MCP Coinbase Commerce Server

✨ Ресурсы

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

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.

📜 Лицензия

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