PayPal MCP Server

Servidor MCP de PayPal

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona integración con las APIs de PayPal. Este servidor permite una interacción fluida con el procesamiento de pagos, facturación, gestión de suscripciones y operaciones comerciales de PayPal a través de una interfaz estandarizada.

Características

• Procesamiento de Pagos: Crear y capturar pagos, órdenes y tokens de pago
• Gestión de Suscripciones: Crear y gestionar suscripciones recurrentes
• Operaciones Comerciales: Crear productos, facturas y procesar pagos
• Gestión de Usuarios: Recuperar información de usuarios y crear perfiles web
• Autenticación Segura: Gestión automática de tokens con manejo de renovación
• Validación de Entradas: Validación exhaustiva mediante esquemas de Zod
• Manejo de Errores: Manejo robusto de errores y registro de actividades

Instalación

# 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

Configuración

Cree un archivo .env en el directorio raíz con sus credenciales de la API de PayPal:

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

Uso

Ejecutar el Servidor

# Start the server
npm start

# For development with auto-reload
npm run dev

Configuración de MCP

Agregue el servidor a su archivo de configuración de 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": []
    }
  }
}

Herramientas Disponibles

Herramientas de Pago

• create_payment_token: Crear un token de pago para uso futuro
• create_order: Crear una nueva orden en PayPal
• capture_order: Capturar el pago de una orden autorizada
• create_payment: Crear un pago directo
• create_subscription: Crear una suscripción para facturación recurrente

Herramientas Comerciales

• create_product: Crear un nuevo producto en el catálogo
• create_invoice: Generar una nueva factura
• create_payout: Procesar un pago por lotes

Herramientas de Usuario

• get_userinfo: Recuperar información del usuario
• create_web_profile: Crear un perfil de experiencia web
• get_web_profiles: Obtener la lista de perfiles de experiencia web

Desarrollo

# Run linting
npm run lint

# Run tests
npm test

# Format code
npm run format

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENSE para más detalles.