프로젝트 소개

Google Analytics 4 (GA4) MCP Server는 AI 에이전트에게 GA4 속성에 직접적이고 분석 준비된 접근을 제공하는 Model Context Protocol 서버입니다. 스키마 탐색, 서버 측 메트릭 집계, 안전한 기본 설정 등을 통해 수동 데이터 정제 과정을 제거합니다. 서버는 Claude Desktop, Cursor, Claude Code, VS Code(Cline/Roo Code/Continue), Zed, Windsurf 등 인기 MCP 클라이언트를 자동 구성하는 단일 명령어 설치 프로그램을 통해 설치할 수 있습니다. 또한 PyPI에서 Python 패키지로, `@surendranb` 범위 아래 npm 패키지로도 제공됩니다. 사용 가능한 도구에는 자동 합계 기능을 갖춘 다차원 GA4 보고서 실행, 계정 및 속성 목록 조회, 완전한 차원 및 메트릭 스키마 가져오기, 실시간 활성 사용자 및 이벤트 수 조회, 내장 분석 기술 검색 등이 포함됩니다. GitHub에서 동적으로 로드되는 기술은 트래픽 진단, 채널 유입, 전자상거래 분석, AI 리퍼럴 분석(ChatGPT, Claude, Perplexity, Gemini 리퍼럴 트래픽 추적)을 커버합니다. 인증은 Google 서비스 계정 JSON 파일과 GA4 속성 ID가 필요하며, 환경 변수 또는 클라이언트별 설정 파일을 통해 구성할 수 있습니다. 패키지는 기본적으로 익명의 비PII 텔레메트리를 수집하며, `DO_NOT_TRACK=1` 또는 `MCP_TELEMETRY_OPT_OUT=1`을 통해 비활성화할 수 있습니다. 라이선스: MIT.