Paytm MCP Server

Un servidor para gestionar enlaces de pago y transacciones de Paytm.

Documentación

Paytm MCP Server

Un servidor MCP (Panel de Control de Comerciante) basado en Python para gestionar enlaces de pago y transacciones de Paytm.

Características

  • Crear enlaces de pago de Paytm para clientes
  • Obtener todos los enlaces de pago creados
  • Recuperar transacciones para un enlace de pago específico

Requisitos previos

  • Python 3.12 o superior
  • Credenciales de comerciante de Paytm:
    • PAYTM_MID
    • PAYTM_KEY_SECRET
  • Las siguientes dependencias de Python:
    • httpx>=0.28.1
    • mcp[cli]>=1.7.0
    • paytmchecksum
    • pycryptodome
    • requests
  • uv (un instalador y ejecutor de paquetes de Python rápido)
  • Claude Desktop (para ejecutar y gestionar el servidor)

Instalación

Opción 1: Configuración automatizada (Recomendada)

Utilice el script setup.sh proporcionado para la instalación y configuración automatizadas:

# Make the script executable
chmod +x setup.sh

# Run the setup script
./setup.sh

El script hará lo siguiente:

  1. Verificar las dependencias requeridas (Python 3.12+, uv, Claude Desktop)
  2. Clonar o actualizar el repositorio
  3. Crear y activar un entorno virtual
  4. Instalar todas las dependencias requeridas
  5. Crear una plantilla de archivo .env para las credenciales de Paytm

Opción 2: Instalación manual

  1. Clonar el repositorio:

    git clone git@bitbucket.org:paytmteam/payment-mcp.git
    cd payment-mcp
    
  2. Crear y activar un entorno virtual:

    uv venv
    source .venv/bin/activate
    
  3. Instalar dependencias:

    uv pip install .
    

Configuración

  1. Crear un archivo .env en la raíz del proyecto:

    # Paytm credentials
    PAYTM_MID=your_paytm_mid
    PAYTM_KEY_SECRET=your_paytm_key_secret
    
  2. Actualizar el archivo .env con sus credenciales reales de Paytm

Ejecutar el servidor MCP con Claude Desktop

El servidor está diseñado para ser gestionado y ejecutado mediante Claude Desktop. No necesita ejecutar el servidor manualmente desde la línea de comandos.

Ejemplo de claude_desktop_config.json

Coloque este archivo en la raíz de su proyecto o según lo requiera Claude Desktop:

{
  "mcpServers": {
    "paytm-mcp-server": {
      "command": "uv path",
      "args": ["--directory", "path to project", "run", "paytm_mcp.py"],
      "env": {
        "PAYTM_MID": "****************",
        "PAYTM_KEY_SECRET": "************"
      }
    }
  }
}
  • Actualice las rutas de command y args según sea necesario para su entorno.
  • La sección env debe contener sus credenciales reales de Paytm.

Próximos pasos

  1. Actualice el claude_desktop_config.json con sus credenciales de Paytm
  2. Reinicie el servidor usando Claude Desktop

Estructura del proyecto

  • paytm_mcp.py: Punto de entrada principal del servidor y definiciones de herramientas
  • services/: Lógica de negocio para pagos
  • config/: Configuración y ajustes
  • utils/: Modelos de datos y utilidades

Licencia

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

La Licencia MIT es una licencia permisiva que le permite:

  • Usar el código comercialmente
  • Modificar el código
  • Distribuir el código
  • Usar el código de forma privada
  • Sublicenciar el código

El único requisito es que la licencia y el aviso de copyright deben incluirse en todas las copias o partes sustanciales del software.