MCP Stripe Server

MCP Stripe Server

Uma implementação de servidor Model Context Protocol (MCP) que se integra ao Stripe para lidar com pagamentos, clientes e reembolsos. Este servidor fornece uma API estruturada para gerenciar transações financeiras de forma segura.

Demonstração

Requisitos

• Python 3.8+
• MCP SDK 0.1.0+
• Stripe Python SDK
• dotenv

Componentes

Recursos

O servidor fornece registro de auditoria de todas as operações do Stripe:

• Armazena registros de auditoria de operações de clientes, pagamentos e reembolsos
• Suporta registro estruturado para melhor rastreabilidade
• Usa endpoints de recursos do MCP para recuperar dados de auditoria

Ferramentas

O servidor implementa operações da API do Stripe, incluindo:

Gerenciamento de Clientes

• customer_create: Criar um novo cliente
• customer_retrieve: Recuperar os detalhes de um cliente
• customer_update: Atualizar informações do cliente

Operações de Pagamento

• payment_intent_create: Criar uma intenção de pagamento para processar pagamentos
• charge_list: Listar cobranças recentes

Operações de Reembolso

• refund_create: Criar um reembolso para uma cobrança

Recursos

• Pagamentos Seguros: Integra-se ao Stripe para processamento robusto de pagamentos
• Registro de Auditoria: Mantém o registro de todas as transações do Stripe
• Tratamento de Erros: Tratamento abrangente de erros com mensagens claras
• Integração MCP: Suporta ferramentas compatíveis com MCP e listagem de recursos

Instalação

Instalando via Smithery

Para instalar o Stripe Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @atharvagupta2003/mcp-stripe --client claude

Instalar dependências

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows
pip install -e .

Configuração

Configure as variáveis de ambiente em um arquivo .env:

STRIPE_API_KEY=your_stripe_secret_key

Claude Desktop

Adicione a configuração do servidor ao seu arquivo de configuração do Claude Desktop:

Windows: C:\Users\AppData\Roaming\Claude\claude_desktop_config.json

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src",
        "run",
        "server.py"
      ]
    }
  }
}

Uso

Iniciar o servidor

uv run src/server.py

Exemplos de Comandos MCP

Criar um cliente

{
    "tool": "customer_create",
    "arguments": {
        "email": "customer@example.com",
        "name": "John Doe"
    }
}

Recuperar um cliente

{
    "tool": "customer_retrieve",
    "arguments": {
        "customer_id": "cus_123456"
    }
}

Criar uma intenção de pagamento

{
    "tool": "payment_intent_create",
    "arguments": {
        "amount": 5000,
        "currency": "usd",
        "customer": "cus_123456"
    }
}

Criar um reembolso

{
    "tool": "refund_create",
    "arguments": {
        "charge_id": "ch_abc123"
    }
}

Tratamento de Erros

O servidor fornece mensagens de erro claras para cenários comuns:

• Chave de API ausente: STRIPE_API_KEY é obrigatória
• Chave de API inválida: Erro de autenticação
• Cliente não encontrado: ID de cliente inválido
• Entrada inválida: Parâmetros ausentes ou incorretos

Desenvolvimento

Testes

Execute o MCP Inspector para testes interativos:

npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/src run server.py

Compilação

1. Atualize as dependências:

uv compile pyproject.toml

2. Compile o pacote:

uv build

Contribuições

Aceitamos contribuições! Consulte nossas Diretrizes de Contribuição para obter detalhes.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.