Marketing Automation MCP Server

Automatiza operações de marketing com otimização baseada em IA, análises em tempo real e integração multiplataforma.

GitHub
3
Experimente este MCPPatrocinado

Documentação

Servidor MCP de Automação de Marketing

marketing-automation-mcp é um servidor MCP em Python para relatórios de campanha determinísticos, otimização de orçamento com suporte do provedor, geração de copy e segmentação de audiência apenas para demonstração.

Este repositório agora prioriza reprodutibilidade em vez de configuração ad hoc:

  • Python suportado: 3.12 e 3.13
  • Bootstrap local: uv
  • Transporte MCP principal: stdio
  • Python local 3.14.x é tratado como trabalho de compatibilidade, não como base suportada

Escopo Atual

O contrato MCP público neste repositório é intencionalmente restrito:

  • generate_campaign_report
  • optimize_campaign_budget
  • create_campaign_copy
  • analyze_audience_segments

Apenas essas quatro ferramentas fazem parte da superfície suportada do servidor hoje. Outros módulos em src/tools/ existem como caminhos de código internos ou aspiracionais e não devem ser tratados como recursos MCP de produção.

Modos de Execução

  • DEMO_MODE=true Retorna dados de amostra determinísticos para demonstrações e testes de contrato.
  • DEMO_MODE=false Usa credenciais reais da plataforma e o provedor de IA selecionado. Dependências ao vivo ausentes retornam respostas estruturadas de blocked em vez de saída fabricada.

Configuração em Máquina Limpa

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

Se você precisar de um fallback para pip:

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

Executar o Servidor

Inicie o servidor MCP no seu modo de transporte suportado:

uv run python -m src.server

O servidor atualmente documenta e suporta apenas o transporte stdio.

Configuração do 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

Configurações mínimas úteis:

  • Apenas modo demonstração:
    • DEMO_MODE=true
  • Relatórios e otimização ao vivo:
    • DEMO_MODE=false
    • um ou mais conjuntos de credenciais da plataforma
  • Geração de copy ao vivo:
    • DEMO_MODE=false
    • AI_PROVIDER=openai
    • OPENAI_API_KEY=...
    • AI_OPENAI_MODEL=gpt-5.4

Variáveis de ambiente opcionais do provedor:

  • ANTHROPIC_API_KEY, ANTHROPIC_MODEL
  • GEMINI_API_KEY, GEMINI_MODEL

Para comportamento estável ao vivo, defina:

  • SECRET_KEY
  • ENCRYPTION_KEY

Se ENCRYPTION_KEY estiver ausente, a criptografia da chave de API é desativada para esse processo e o servidor registra um aviso.

Contrato de Ferramentas

Toda resposta de ferramenta inclui estes campos de nível superior:

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

Consulte o contrato completo em docs/api/README.md.

Efeitos Colaterais Internos de Gravação

Fluxos de relatórios e otimização ao vivo podem persistir registros de auditoria internos no banco de dados configurado:

  • fluxos de relatórios podem persistir snapshots normalizados de campanha
  • fluxos de otimização podem persistir histórico de decisões da IA

Essas gravações são efeitos colaterais internos para observabilidade e segurança de replay. Elas não fazem parte do contrato público de resposta MCP.

Comandos de Validação

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 .

Documentação