MCP Stripe Server

MIT License
13
  • Apple

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows to manage Stripe payment operations including customer management, payment intents, charges, and refunds through a structured API

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

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
  1. 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.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor que se integra con Stripe para gestionar pagos, clientes y reembolsos a través del Protocolo de Contexto de Modelo, proporcionando una API segura para administrar transacciones financieras.

  1. Demo
    1. Requirements
    2. Components
    3. Features
    4. Installation
    5. Usage
    6. Error Handling
    7. Development
    8. License
ID: wiypoirrk3