de en es ja ko pt ru zh

Gotas Commerce MCP Server

Name: Gotas Commerce MCP Server
Author: caiovicentino

by caiovicentino

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

放弃商务 API 和 MCP 集成

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

🚀 概述

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

Related MCP server: BlindPay MCP Server

✨ 资源

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 助手可以轻松使用的工具、资源和提示。

┌────────────────┐    ┌───────────────┐    ┌──────────────────┐
│                │    │               │    │                  │
│  Assistente IA ├────┤  Servidor MCP ├────┤  API Gotas       │
│  (Claude)      │    │  (FastAPI)    │    │  Commerce        │
│                │    │               │    │                  │
└────────────────┘    └───────────────┘    └──────────────────┘

📋 先决条件

Python 3.8 或更高版本
Gotas Commerce API 密钥（获取地址： commerce.gotas.com ）
访问与 MCP 兼容的助手（例如 Claude）

🔌 安装

克隆此存储库：

git clone https://github.com/caiovicentino/mcpGOTAS.git
cd mcpGOTAS

安装依赖项：
```
pip install -r requirements.txt
```
或者使用自动安装脚本：
```
./setup.bat
```

配置环境变量：

使用以下值创建.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 一起使用：

python install_claude.py

或者，手动安装：

mcp install src.gotas_mcp_server.py

直接 API 使用（测试脚本）

对于不使用向导的直接测试：

创建付款： python test_client.py
检查状态： python check_payment.py

📊 付款流程

付款初始化：
- 服务员从用户处获取金额和其他付款详细信息。
- 向导使用所需参数调用create-payment工具
- Gotas Commerce 中创建了一笔新付款
- 支付链接返回给用户
付款流程：
- 用户访问提供的付款链接
- 用户将USDT转入显示的钱包地址
- Gotas Commerce 监控区块链以确认交易
状态检查：
- 助手可以通过调用check-payment-status status 来检查付款状态
- 状态可以是：待定、已完成、已过期或失败。
- 当付款确认后，区块链交易哈希即可提供。

🔍 技术规格

API 详细信息

删除 Commerce 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（服务器发送事件）
格式：JSON，用于助手和 MCP 服务器之间的通信
身份验证：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 工具，实现服务器上用@mcp.tool()装饰的功能
与其他服务的集成：该架构允许您轻松集成 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 许可证

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

griffnodeOAuth
com.griffnode
Non-custodial crypto payments for AI assistants: balances, payments, and create payment links.
Cryptocurrency Payments & Billing
2
mifactory-payments A
io.github.mifactory-bot
Stripe payments for AI agents. Create links, verify, manage customers.
Payments & Billing Finance App Automation
42
Taiwan Payments & E-Invoice (ECPay 綠界 / NewebPay 藍新)A
app.wishpool
Taiwan payments (ECPay 綠界 + NewebPay 藍新) & e-invoices for AI agents. Stateless, never holds funds.
Payments & Billing Finance
2
mcp A
io.github.ShieldZCash
Keyless non-custodial crypto payments for AI agents: payment links and tip jars, no API key.
Cryptocurrency Payments & Billing
42

Related MCP Servers

MCP Coinbase Commerce Server
Cryptocurrency Blockchain
zhangzhongnan928
F
license
Not graded
quality
D
maintenance
Connects to the Coinbase Commerce API, allowing AI assistants like Claude to generate cryptocurrency payment links.
Updated 2 years ago (2025-03-05 00:57 UTC)
-
BlindPay MCP Server
Finance Blockchain Web3 & Decentralized Tech
blindpaylabs
A
license
Not graded
quality
A
maintenance
Enables AI assistants to interact with BlindPay's stablecoin payment infrastructure, allowing users to create receivers, process payouts and payins across multiple blockchains, manage virtual accounts and wallets, and configure payment operations through natural language.
Updated a month ago (2026-08-08 15:07 UTC)
55 npm
10
MIT
MCP Bitnovo Payofficial
Cryptocurrency Finance Agent Orchestration
bitnovo
A
license
A
quality
C
maintenance
Enables AI agents to create cryptocurrency payments, check payment status, generate QR codes, and manage transactions through Bitnovo Pay API integration with automatic webhook support.
Updated a year ago (2025-10-23 10:25 UTC)
5
6 npm
4
MIT
@chainpayto/mcp-serverofficial
Blockchain Cryptocurrency Payments & Billing
chainpayto
A
license
A
quality
D
maintenance
Enables AI agents to directly operate ChainPay cryptocurrency payment system, including order creation, balance checks, and withdrawals.
Updated 5 months ago (2026-04-24 12:16 UTC)
6
5 npm
MIT

放弃商务 API 和 MCP 集成

🚀 概述

✨ 资源

MCP 工具

create-payment

check-payment-status

MCP 资源

payment-status://{payment_id}

MCP 提示

create-payment-prompt

🔧 架构

📋 先决条件

🔌 安装

🏃‍♂️ 执行

MCP 服务器

与 Claude Desktop 集成

直接 API 使用（测试脚本）

📊 付款流程

🔍 技术规格

API 详细信息

MCP 通信

📂 项目结构

🔒 安全

🧩 可扩展性

📚 使用示例

创建付款（通过 Claude）

检查状态（通过 Claude）

📞 支持与联系

📜 许可证

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP Coinbase Commerce Server

BlindPay MCP Server

MCP Bitnovo Payofficial

@chainpayto/mcp-serverofficial

`create-payment`

`check-payment-status`

`payment-status://{payment_id}`

`create-payment-prompt`