Servidor de rayas MCP

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que se integra con Stripe para gestionar pagos, clientes y reembolsos. Este servidor proporciona una API estructurada para gestionar transacciones financieras de forma segura.

Manifestación

Requisitos

• Python 3.8+

• SDK de MCP 0.1.0+

• SDK de Python de Stripe

• dotenv

Related MCP server: Stripe MCP Server

Componentes

Recursos

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

• Almacena registros de auditoría de operaciones de clientes, pagos y reembolsos.

• Admite el registro estructurado para una mejor trazabilidad

• Utiliza puntos finales de recursos MCP para recuperar datos de auditoría

Herramientas

El servidor implementa operaciones de la API de Stripe, que incluyen:

Gestión de clientes

• customer_create : Crea un nuevo cliente

• customer_retrieve : Recuperar los detalles de un cliente

• customer_update : Actualizar la información del cliente

Operaciones de pago

• payment_intent_create : Crea una intención de pago para procesar pagos

• lista_de_cargos : Lista de cargos recientes

Operaciones de reembolso

• refund_create : Crea un reembolso por un cargo

Características

• Pagos seguros : se integra con Stripe para un manejo sólido de pagos

• Registro de auditoría : realiza un seguimiento de todas las transacciones de Stripe

• Manejo de errores : Manejo de errores integral con mensajes claros

• Integración con MCP : admite herramientas compatibles con MCP y listado de recursos

Instalación

Instalación mediante herrería

Para instalar Stripe Server para Claude Desktop automáticamente a través de 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

Configure las variables de entorno en un archivo .env :

STRIPE_API_KEY=your_stripe_secret_key

Escritorio de Claude

Agregue la configuración del servidor a su configuración de Claude Desktop:

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

MacOS: ~/Biblioteca/Soporte de aplicaciones/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

Ejemplos de comandos MCP

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 : se requiere STRIPE_API_KEY

• Clave API no válida : Error de autenticación

• Cliente no encontrado : ID de cliente no válido

• Entrada no válida : parámetros faltantes o incorrectos

Desarrollo

Pruebas

Ejecute el Inspector MCP para realizar pruebas interactivas:

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

Edificio

1. Actualizar dependencias:

uv compile pyproject.toml

2. Paquete de compilación:

uv build

Contribuyendo

¡Agradecemos sus contribuciones! Consulte nuestras Pautas de Contribución para más detalles.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.