Gotas Commerce MCP Server

放弃商务 API 和 MCP 集成

使用 MCP（模型上下文协议）实现加密货币支付集成的强大解决方案，允许像 Claude 这样的 AI 助手通过 Gotas Commerce API 创建和验证 USDT 交易。

🚀 概述

该项目在人工智能助手和加密货币支付服务之间架起了一座桥梁。通过实现 MCP 服务器，助手无需专门的区块链技术知识即可生成支付链接、检查交易状态并获取有关 USDT 支付的详细信息。

✨ 资源

MCP 工具

create-payment

创建一个新的 USDT 支付交易并返回所有必需的详细信息，包括支付 URL 和钱包地址。

参数：

• amount ：付款金额（例如：100.50）
• currency ：货币代码（目前仅为“USDT”）
• return_url ：付款后重定向客户的 URL
• description ：可选付款描述

返回：

• 包含所有付款详细信息的完整 JSON 对象：
  • 唯一付款ID
  • 付款网址
  • 钱包地址
  • 状态（待处理、完成、失败、过期）
  • 创建日期和到期日期
  • 其他相关元数据

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转入显示的钱包地址
   • Gotas Commerce 监控区块链以确认交易
3. 状态检查：
   • 助手可以通过调用check-payment-status status 来检查付款状态
   • 状态可以是：待定、已完成、已过期或失败。
   • 当付款确认后，区块链交易哈希即可提供。

🔍 技术规格

API 详细信息

删除 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（服务器发送事件）
• 格式：JSON，用于助手和 MCP 服务器之间的通信
• 身份验证：API 密钥存储为环境变量

📂 项目结构

🔒 安全

• API 密钥存储为环境变量，而不是源代码
• 与 Gotas Commerce API 的通信通过 HTTPS 完成
• MCP 服务器在发送至 API 之前验证所有参数
• 适当的错误处理以避免泄露敏感信息

🧩 可扩展性

该项目旨在轻松扩展：

1. 新功能：添加新的 MCP 工具，实现服务器上用@mcp.tool()装饰的功能
2. 与其他服务的集成：该架构允许您轻松集成 Gotas Commerce 之外的其他服务
3. 新币支持：该框架准备在未来支持除 USDT 之外的其他加密货币

📚 使用示例

创建付款（通过 Claude）

检查状态（通过 Claude）

📞 支持与联系

如需支持或其他信息，请联系 Gotas 开发团队或在 GitHub 存储库中打开问题。

📜 许可证

MIT 许可证