🇪🇨 MCP Datafast

Servidor Model Context Protocol (MCP) para la integración con la red Datafast.

Parte del ecosistema oficial de MCP Hub Ecuador.

Important

🤖 Nota para Agentes IA: Antes de interactuar con este servidor, por favor revisa el Agent Cheatsheet en nuestro Hub principal para comprender las reglas de negocio, cálculo de IVA (15%) y formatos de identificación de Ecuador.

🚀 Características

• Procesamiento tradicional de tarjetas en Ecuador.
• Consulta de estados en la red Datafast.
• Arquitectura Enterprise: Imágenes Docker ultra-ligeras con Healthchecks nativos, logs estructurados en JSON y validación continua de seguridad.

🛠️ Herramientas Disponibles

• checkout_id: Genera un ID de checkout para iniciar el pago.
• verificar_estado: Verifica el estado de una transacción.

📦 Instalación y Configuración

1. Variables de Entorno

Este servidor es completamente stateless. Copia el archivo .env.example a .env y configura tus datos. Nunca hagas commit de este archivo.

DATAFAST_ENTITY_ID="tu_entity_id"
DATAFAST_BEARER_TOKEN="tu_token"

2. Despliegue con Docker (Recomendado)

Para entornos de producción o pruebas limpias, recomendamos usar nuestra imagen oficial alojada en GitHub Container Registry (ghcr.io).

Vía Docker CLI:

docker run -d \
  --name mcp-datafast \
  --env-file .env \
  ghcr.io/mcphub-ec/mcp-datafast:latest

Vía Docker Compose:

services:
  mcp-datafast:
    image: ghcr.io/mcphub-ec/mcp-datafast:latest
    container_name: mcp-datafast
    env_file:
      - .env
    restart: unless-stopped

3. Uso con Claude Desktop (Local)

Si deseas conectarlo directamente a tu cliente de Claude para desarrollo local, añade la siguiente configuración a tu archivo claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-datafast": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file",
        "/ruta/absoluta/a/tu/.env",
        "ghcr.io/mcphub-ec/mcp-datafast:latest"
      ]
    }
  }
}

(Nota: También puedes correrlo directamente con python -m server si clonas el repositorio y manejas tu propio entorno virtual).

🔒 Seguridad y Gobernanza

Este proyecto sigue estándares estrictos de seguridad:

• Stateless: No almacena credenciales ni certificados en bases de datos.
• Escaneo de Vulnerabilidades: Cada Pull Request es analizado automáticamente con bandit y detect-secrets.
• Responsible Disclosure: Si encuentras una vulnerabilidad, por favor no abras un Issue público. Revisa nuestro SECURITY.md y contáctanos directamente a security@mcphub.ec.

🤝 Contribuir

Si deseas proponer mejoras, por favor revisa nuestra Guía de Contribución en el repositorio central. ¡Todos los Pull Requests que pasen los checks de CI/CD son bienvenidos!

---

🏢 Desarrollado y Respaldado por

Este ecosistema de código abierto es orgullosamente creado y mantenido por UPGRADE-EC S.A.S.

Si buscas implementar estas tecnologías a escala corporativa, explorar nuestras soluciones comerciales de facturación listas para usar, o necesitas consultoría experta en automatización con IA, visítanos en:

🌐 upgrade.ec