🇪🇨 MCP Factuplan

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

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

• APIs especializadas para emisión de facturas electrónicas mediante el proveedor Factuplan.
• Arquitectura Enterprise: Imágenes Docker ultra-ligeras con Healthchecks nativos, logs estructurados en JSON y validación continua de seguridad.

🛠️ Herramientas Disponibles

• emitir_factura: Genera el comprobante usando la plataforma Factuplan.

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

FACTUPLAN_API_KEY="tu_api_key_aqui"

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-factuplan \
  --env-file .env \
  ghcr.io/mcphub-ec/mcp-factuplan:latest

Vía Docker Compose:

services:
  mcp-factuplan:
    image: ghcr.io/mcphub-ec/mcp-factuplan:latest
    container_name: mcp-factuplan
    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-factuplan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file",
        "/ruta/absoluta/a/tu/.env",
        "ghcr.io/mcphub-ec/mcp-factuplan: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