MCP-сервер автоматизации маркетинга

marketing-automation-mcp — это MCP-сервер на Python для детерминированной отчетности по кампаниям, оптимизации бюджета на основе провайдеров, генерации текстов и демонстрационной сегментации аудитории.

Этот репозиторий теперь отдает предпочтение воспроизводимости, а не специальной настройке:

• Поддерживаемый Python: 3.12 и 3.13

• Локальная загрузка: uv

• Основной транспорт MCP: stdio

• Локальный Python 3.14.x рассматривается как работа по обеспечению совместимости, а не как поддерживаемая базовая версия

Текущая область применения

Публичный контракт MCP в этом репозитории намеренно ограничен:

• generate_campaign_report

• optimize_campaign_budget

• create_campaign_copy

• analyze_audience_segments

Только эти четыре инструмента на сегодняшний день являются частью поддерживаемой серверной поверхности. Другие модули в src/tools/ существуют как внутренние или перспективные пути кода и не должны рассматриваться как производственные функции MCP.

Related MCP server: Google Ads MCP Server

Режимы выполнения

• DEMO_MODE=true Возвращает детерминированные выборочные данные для демонстраций и тестирования контрактов.

• DEMO_MODE=false Использует реальные учетные данные платформы и выбранного ИИ-провайдера. Отсутствующие «живые» зависимости возвращают структурированные ответы blocked вместо сфабрикованных выходных данных.

Настройка чистой машины

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

Если вам нужен резервный вариант pip:

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

Запуск сервера

Запустите MCP-сервер в поддерживаемом режиме транспорта:

uv run python -m src.server

В настоящее время сервер документирует и поддерживает только транспорт stdio.

Конфигурация Claude Desktop:

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

Настройка

cp .env.example .env

Минимально полезные конфигурации:

• Только демонстрационный режим:

  • DEMO_MODE=true

• «Живая» отчетность и оптимизация:

  • DEMO_MODE=false

  • один или несколько наборов учетных данных платформы

• «Живая» генерация текстов:

  • DEMO_MODE=false

  • AI_PROVIDER=openai

  • OPENAI_API_KEY=...

  • AI_OPENAI_MODEL=gpt-5.4

Дополнительные переменные среды провайдера:

• ANTHROPIC_API_KEY, ANTHROPIC_MODEL

• GEMINI_API_KEY, GEMINI_MODEL

Для стабильной работы в «живом» режиме установите:

• SECRET_KEY

• ENCRYPTION_KEY

Если ENCRYPTION_KEY отсутствует, шифрование API-ключа для этого процесса отключается, и сервер записывает предупреждение в журнал.

Контракт инструментов

Каждый ответ инструмента включает следующие поля верхнего уровня:

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

Полный контракт см. в docs/api/README.md.

Внутренние побочные эффекты записи

Потоки «живой» отчетности и оптимизации могут сохранять внутренние записи аудита в настроенной базе данных:

• потоки отчетов могут сохранять нормализованные снимки кампаний

• потоки оптимизации могут сохранять историю решений ИИ

Эти записи являются внутренними побочными эффектами для наблюдаемости и безопасности повторного воспроизведения. Они не являются частью публичного контракта ответов MCP.

Команды проверки

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 .

Документация

• Краткое руководство

• Справочник API

• Примеры рабочих процессов

• Демонстрационное руководство

• Руководство оператора

• Документация по аудиту системы