Marketing Automation MCP Server

Automatiza operaciones de marketing con optimización impulsada por IA, análisis en tiempo real e integración multiplataforma.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Marketing Automation MCP Server

marketing-automation-mcp es un servidor MCP de Python para informes de campañas deterministas, optimización de presupuestos respaldada por proveedores, generación de copys y segmentación de audiencias solo para demostraciones.

Este repositorio ahora prioriza la reproducibilidad sobre la configuración ad hoc:

  • Python compatible: 3.12 y 3.13
  • Arranque local: uv
  • Transporte MCP principal: stdio
  • El 3.14.x local de Python se trata como trabajo de compatibilidad, no como la base compatible

Alcance actual

El contrato MCP público en este repositorio es intencionalmente limitado:

  • generate_campaign_report
  • optimize_campaign_budget
  • create_campaign_copy
  • analyze_audience_segments

Solo estas cuatro herramientas forman parte de la superficie de servidor compatible hoy en día. Otros módulos bajo src/tools/ existen como rutas de código internas o aspiracionales y no deben tratarse como funciones MCP de producción.

Modos de ejecución

  • DEMO_MODE=true Devuelve datos de muestra deterministas para demostraciones y pruebas de contrato.
  • DEMO_MODE=false Utiliza credenciales reales de la plataforma y el proveedor de IA seleccionado. Las dependencias en vivo faltantes devuelven respuestas estructuradas blocked en lugar de resultados inventados.

Configuración de máquina limpia

uv sync --python 3.13 --extra dev
cp .env.example .env
uv run python -m compileall src tests dashboard
uv run pytest

Si necesitas un respaldo de pip:

python3.13 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Ejecutar el servidor

Inicia el servidor MCP en su modo de transporte compatible:

uv run python -m src.server

El servidor actualmente documenta y admite únicamente el transporte stdio.

Configuración de Claude Desktop:

{
  "mcpServers": {
    "marketing-automation": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.server"],
      "cwd": "/absolute/path/to/Marketing-Automation-MCP-Server"
    }
  }
}

Configurar

cp .env.example .env

Configuraciones mínimas útiles:

  • Solo modo demo:
    • DEMO_MODE=true
  • Informes y optimización en vivo:
    • DEMO_MODE=false
    • uno o más conjuntos de credenciales de plataforma
  • Generación de copys en vivo:
    • DEMO_MODE=false
    • AI_PROVIDER=openai
    • OPENAI_API_KEY=...
    • AI_OPENAI_MODEL=gpt-5.4

Variables de entorno opcionales del proveedor:

  • ANTHROPIC_API_KEY, ANTHROPIC_MODEL
  • GEMINI_API_KEY, GEMINI_MODEL

Para un comportamiento en vivo estable, establece:

  • SECRET_KEY
  • ENCRYPTION_KEY

Si falta ENCRYPTION_KEY, el cifrado de claves API está deshabilitado para ese proceso y el servidor registra una advertencia.

Contrato de herramientas

Cada respuesta de herramienta incluye estos campos de nivel superior:

{
  "status": "ok | blocked",
  "mode": "demo | live",
  "blocked_reason": "optional string",
  "warnings": []
}

Consulta el contrato completo en docs/api/README.md.

Efectos secundarios de escritura internos

Los flujos de informes y optimización en vivo pueden persistir registros de auditoría internos en la base de datos configurada:

  • los flujos de informes pueden persistir instantáneas de campañas normalizadas
  • los flujos de optimización pueden persistir el historial de decisiones de IA

Estas escrituras son efectos secundarios internos para la observabilidad y la seguridad de reproducción. No forman parte del contrato público de respuestas MCP.

Comandos de validación

uv run python -m compileall src tests dashboard
uv run pytest
uv run python -c "import src.server, src.cli, src.ai_engine, src.performance; print('imports ok')"
docker build -t marketing-automation-mcp:latest .

Documentación