td-taxonomy-mcp

ThinkingData 이벤트 택소노미 설계 도우미 MCP 서버.

서비스에 맞는 이벤트 택소노미를 설계하고, 검증하고, 엑셀/마크다운으로 내보낼 수 있습니다.

설치

npm install -g td-taxonomy-mcp

Claude Desktop 설정

claude_desktop_config.json:

{
  "mcpServers": {
    "td-taxonomy": {
      "command": "npx",
      "args": ["td-taxonomy-mcp"]
    }
  }
}

도구 목록

| 도구 | 설명 | |------|------| | taxonomy_guide | TE 이벤트 체계, 워크플로우, 트래킹 레벨, SDK 자동수집 등 | | taxonomy_template | 빈 택소노미 템플릿 구조 (시트별 열 정의) | | intake_taxonomy | NEW — 사용자 자료(PDF/MD/스크린샷 텍스트)를 받아 누락 정보 식별 + 질문 생성 | | generate_events | 서비스 설명 + tracking_level → #이벤트 데이터 시트 설계 컨텍스트 | | generate_user_id | 계정 유형 → #유저 ID 체계 시트 생성 | | generate_common_props | 서비스 설명 → #공통 이벤트 속성 시트 설계 컨텍스트 | | generate_user_props | 서비스 설명 → #유저 데이터 시트 설계 컨텍스트 | | validate_taxonomy | 택소노미 검증 (네이밍, 유형, 우선순위, tracking_level 적합성) | | export_taxonomy | xlsx로 내보내기 (우선순위 색상 시각화 포함) |

트래킹 레벨 (NEW)

generate_events의 tracking_level 매개변수로 설계 깊이 결정:

| 레벨 | 설명 | 이벤트 수 | 우선순위 | 사용 시점 | |------|------|----------|----------|----------| | min | 최소 지표 중심 (가입/구매/이탈) | 5~15개 | P0만 | MVP, 빠른 검증 | | flow | 주요 플로우 (퍼널/리텐션) | 20~50개 | P0+P1 | 정식 출시, 일반적 | | full | 전수 (모든 행동) | 100~200개 | P0~P3 | 게임/금융/대규모 |

#이벤트 데이터 시트의 5번째 컬럼 우선순위에 P0~P3 입력. xlsx 출력 시 색상 시각화 (P0=빨강, P1=주황, P2=파랑, P3=회색).

워크플로우

사용자 자료(PDF/MD/스크린샷) → LLM이 텍스트 추출
         ↓
[1] intake_taxonomy        ← 누락 정보 검토 + 질문 생성
         ↓
[2] (사용자에게 질문 → 답변)
         ↓
[3] generate_events + generate_user_id + generate_common_props + generate_user_props
         ↓
[4] LLM이 마크다운 4개 테이블 작성
         ↓
[5] validate_taxonomy      ← 네이밍/우선순위/레벨 검증
         ↓
[6] export_taxonomy(xlsx)  ← 최종 .xlsx 파일 출력

자세한 가이드: taxonomy_guide(topic: 'workflow'), taxonomy_guide(topic: 'tracking_levels')

사용 예시

새 게임 택소노미 설계 (자료 기반)

사용자: [기획 PDF 첨부] "포트리스 사가 게임 택소노미 만들어줘"
LLM: PDF 텍스트 추출 → intake_taxonomy(source_material: ...)
도구: ⚠️ 트래킹 레벨, 계정체계, SDK 미파악 — 질문 리스트 반환
LLM: "트래킹 레벨은? 계정 체계는? SDK는?"
사용자: "full / single_account_multi_profile / unity"
LLM: generate_events(tracking_level: 'full', ...) + 나머지 도구 호출
LLM: 마크다운 작성 → validate_taxonomy → export_taxonomy(format: xlsx)
출력: ./[서비스]_v1.xlsx (우선순위 색상 시각화 포함)

지원 SDK

Android, iOS, Unity, Unreal, Cocos, JavaScript, Server, React Native, Flutter

지원 업종

Game, E-commerce, Fintech, SaaS, Media, Social, Other

라이선스

MIT