gwanjong-mcp CLAUDE.md

gwanjong-mcp

AI Growth OS — Stateful Pipeline MCP 서버 + 자율 소셜 에이전트. 8개 tool + EventBus 플러그인 아키텍처.

핵심 설계: 토큰 효율 + 느슨한 결합

• Tool 8개 — description이 매 호출마다 시스템 프롬프트에 포함되므로 최소화
• 서버 상태 유지 — scout 결과를 GwanjongState에 캐시, ID 참조로 후속 호출
• 서버가 분석 담당 — trending/search/filter/score는 서버 내부 처리, LLM은 판단+생성만
• EventBus — 모듈 간 직접 import 없이 이벤트 pub/sub. 플러그인 유무와 무관하게 동작
• 캠페인 기반 — 모든 활동을 캠페인 단위로 추적, UTM 태깅, 전환 측정

프로젝트 구조

gwanjong_mcp/
├── __init__.py        # 패키지
├── __main__.py        # python -m gwanjong_mcp
├── server.py          # PipelineMCP + 8 tools + GwanjongState + EventBus 조립
├── events.py          # EventBus + Event + Blocked (유일한 공유 지점)
├── pipeline.py        # scout/draft/strike 코어 (registry + EventBus)
├── types.py           # Opportunity, DraftContext, ActionRecord, Campaign, Asset, ...
├── storage.py         # SQLite 스키마 (actions, campaigns, conversions, assets, schedule, ...)
├── setup.py           # 플랫폼 온보딩 (registry 기반 동적 가이드)
├── browser.py         # Dev.to 브라우저 자동화
│
│  ── EventBus 플러그인 (독립 모듈) ──
│
├── safety.py          # Rate limiting + 콘텐츠 검증 (strike.before 차단)
├── memory.py          # SQLite 영속 저장소 (활동 이력 + 중복 방지 + campaign_id/utm_url)
├── tracker.py         # 답글 추적 (댓글 남긴 게시글의 새 답글 감지)
├── conversion.py      # UTM 삽입 + 전환 기록 (strike.before/after)
├── scheduler.py       # 예약 발행 (시간 도래 → 자동 실행)
│
│  ── 독립 모듈 ──
│
├── campaign.py        # Campaign CRUD + KPI 리포트
├── asset.py           # Asset library (에셋 저장/검색/재사용)
├── message.py         # MessageFrame 관리 (ICP별 메시지 프레임)
├── measure.py         # Attribution + A/B 실험 + weekly report
├── strategy.py        # 주간 플랜 자동 생성 + 저위험 자동 스케줄
├── monitor.py         # 모니터링 데이터 집계 (SQLite → JSON)
├── dashboard.py       # 대시보드 웹서버 (aiohttp, 별도 프로세스)
├── static/index.html  # 대시보드 프론트엔드 (단일 HTML, vanilla JS)
├── persona.py         # 플랫폼별 페르소나 관리 (파일 I/O만)
├── llm.py             # 내장 LLM 댓글 생성 (anthropic SDK)
├── autonomous.py      # 자율 루프 엔진 (pipeline + events + scheduler 통합)
├── daemon.py          # gwanjong-daemon CLI 진입점
run.py                 # 직접 실행 진입점