PayPal MCP Server

Servidor MCP do PayPal

Um servidor Model Context Protocol (MCP) que fornece integração com as APIs do PayPal. Este servidor permite interação perfeita com o processamento de pagamentos, faturamento, gerenciamento de assinaturas e operações de negócios do PayPal por meio de uma interface padronizada.

Recursos

• Processamento de Pagamentos: Crie e capture pagamentos, pedidos e tokens de pagamento
• Gerenciamento de Assinaturas: Crie e gerencie assinaturas recorrentes
• Operações de Negócios: Crie produtos, faturas e processe pagamentos em lote
• Gerenciamento de Usuários: Recupere informações do usuário e crie perfis web
• Autenticação Segura: Gerenciamento automático de tokens com tratamento de renovação
• Validação de Entrada: Validação abrangente usando esquemas Zod
• Tratamento de Erros: Tratamento robusto de erros e registro de logs

Instalação

# Clone the repository
git clone https://github.com/arbuthnot-eth/PayPal-MCP-Backdated.git
cd PayPal-MCP-Backdated

# Install dependencies
npm install

# Build the project
npm run build

Configuração

Crie um arquivo .env no diretório raiz com suas credenciais da API do PayPal:

PAYPAL_CLIENT_ID=your_client_id_here
PAYPAL_CLIENT_SECRET=your_client_secret_here
PAYPAL_ENVIRONMENT=sandbox  # or 'live' for production

Uso

Executando o Servidor

# Start the server
npm start

# For development with auto-reload
npm run dev

Configuração do MCP

Adicione o servidor ao seu arquivo de configuração do MCP:

{
  "mcpServers": {
    "paypal": {
      "command": "node",
      "args": ["path/to/paypal-mcp/build/index.js"],
      "env": {
        "PAYPAL_CLIENT_ID": "your_client_id",
        "PAYPAL_CLIENT_SECRET": "your_client_secret",
        "PAYPAL_ENVIRONMENT": "sandbox"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ferramentas Disponíveis

Ferramentas de Pagamento

• create_payment_token: Crie um token de pagamento para uso futuro
• create_order: Crie um novo pedido no PayPal
• capture_order: Capture o pagamento de um pedido autorizado
• create_payment: Crie um pagamento direto
• create_subscription: Crie uma assinatura para cobrança recorrente

Ferramentas de Negócios

• create_product: Crie um novo produto no catálogo
• create_invoice: Gere uma nova fatura
• create_payout: Processe um pagamento em lote

Ferramentas de Usuário

• get_userinfo: Recupere informações do usuário
• create_web_profile: Crie um perfil de experiência web
• get_web_profiles: Obtenha a lista de perfis de experiência web

Desenvolvimento

# Run linting
npm run lint

# Run tests
npm test

# Format code
npm run format

Licença

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