MCP Stripe Server

MCP Stripe Server

Una implementación de servidor del Model Context Protocol (MCP) que se integra con Stripe para gestionar pagos, clientes y reembolsos. Este servidor proporciona una API estructurada para manejar transacciones financieras de forma segura.

Demo

Requisitos

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

Componentes

Recursos

El servidor proporciona registro de auditoría de todas las operaciones de Stripe:

• Almacena registros de auditoría de operaciones de clientes, pagos y reembolsos
• Soporta registro estructurado para una mejor trazabilidad
• Usa endpoints de recursos MCP para recuperar datos de auditoría

Herramientas

El servidor implementa operaciones de la API de Stripe, incluyendo:

Gestión de clientes

• customer_create: Crear un nuevo cliente
• customer_retrieve: Recuperar los detalles de un cliente
• customer_update: Actualizar información del cliente

Operaciones de pago

• payment_intent_create: Crear una intención de pago para procesar pagos
• charge_list: Listar cargos recientes

Operaciones de reembolso

• refund_create: Crear un reembolso para un cargo

Características

• Pagos seguros: Se integra con Stripe para un manejo robusto de pagos
• Registro de auditoría: Mantiene un seguimiento de todas las transacciones de Stripe
• Manejo de errores: Manejo integral de errores con mensajes claros
• Integración MCP: Soporta herramientas compatibles con MCP y listado de recursos

Instalación

Instalación vía Smithery

Para instalar Stripe Server para Claude Desktop automáticamente vía Smithery:

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

Instalar dependencias

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

Configuración

Configura las variables de entorno en un archivo .env:

STRIPE_API_KEY=your_stripe_secret_key

Claude Desktop

Agrega la configuración del servidor a tu configuración de 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 el servidor

uv run src/server.py

Comandos MCP de ejemplo

Crear un cliente

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

Recuperar un cliente

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

Crear una intención de pago

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

Crear un reembolso

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

Manejo de errores

El servidor proporciona mensajes de error claros para escenarios comunes:

• Clave API faltante: STRIPE_API_KEY requerida
• Clave API inválida: Error de autenticación
• Cliente no encontrado: ID de cliente inválido
• Entrada inválida: Parámetros faltantes o incorrectos

Desarrollo

Pruebas

Ejecuta el MCP Inspector para pruebas interactivas:

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

Compilación

1. Actualiza las dependencias:

uv compile pyproject.toml

2. Compila el paquete:

uv build

Contribuciones

¡Agradecemos las contribuciones! Consulta nuestras Pautas de contribución para más detalles.

Licencia

Este proyecto está bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.