마케팅 자동화 MCP 서버

marketing-automation-mcp는 결정론적 캠페인 보고, 공급자 기반 예산 최적화, 문구 생성 및 데모용 타겟 세분화를 위한 Python MCP 서버입니다.

이 저장소는 이제 임시 설정보다 재현성을 우선시합니다:

• 지원되는 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: Meta Ads MCP

실행 모드

• DEMO_MODE=true 데모 및 계약 테스트를 위한 결정론적 샘플 데이터를 반환합니다.

• DEMO_MODE=false 실제 플랫폼 자격 증명과 선택된 AI 공급자를 사용합니다. 라이브 종속성이 누락된 경우, 조작된 출력 대신 구조화된 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를 참조하세요.

내부 쓰기 부작용

라이브 보고 및 최적화 흐름은 구성된 데이터베이스에 내부 감사 기록을 유지할 수 있습니다:

• 보고 흐름은 정규화된 캠페인 스냅샷을 유지할 수 있습니다.

• 최적화 흐름은 AI 의사결정 기록을 유지할 수 있습니다.

이러한 쓰기 작업은 관찰 가능성과 재생 안전성을 위한 내부 부작용입니다. 이는 공개 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 참조

• 예제 워크플로우

• 데모 가이드

• 운영자 런북

• 시스템 감사 검토 문서

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• analyze_audience_segmentsC
• create_campaign_copyB
• generate_campaign_reportB
• optimize_campaign_budgetC