Servidor MCP de Automatización de Marketing

marketing-automation-mcp es un servidor MCP de Python para informes de campañas deterministas, optimización de presupuesto respaldada por proveedores, generación de textos y segmentación de audiencia solo para demostración.

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

• Python compatible: 3.12 y 3.13

• Bootstrap local: uv

• Transporte MCP principal: stdio

• El Python local 3.14.x 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 del 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 características MCP de producción.

Related MCP server: Google Ads MCP Server

Modos de ejecución

• DEMO_MODE=true Devuelve datos de muestra deterministas para demostraciones y pruebas de contrato.

• DEMO_MODE=false Utiliza credenciales de plataforma reales y el proveedor de IA seleccionado. Las dependencias en vivo faltantes devuelven respuestas estructuradas de blocked en lugar de resultados fabricados.

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 una alternativa con 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 solo 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 textos en vivo:

  • DEMO_MODE=false

  • AI_PROVIDER=openai

  • OPENAI_API_KEY=...

  • AI_OPENAI_MODEL=gpt-5.4

Variables de entorno de proveedor opcionales:

• ANTHROPIC_API_KEY, ANTHROPIC_MODEL

• GEMINI_API_KEY, GEMINI_MODEL

Para un comportamiento en vivo estable, configura:

• SECRET_KEY

• ENCRYPTION_KEY

Si falta ENCRYPTION_KEY, el cifrado de claves API se deshabilita 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 interna

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 la repetición. No forman parte del contrato de respuesta MCP público.

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

• Inicio rápido

• Referencia de API

• Flujos de trabajo de ejemplo

• Guía de demostración

• Manual de operaciones

• Documentos de revisión de auditoría del sistema