surendranb/google-analytics-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

244 stars 49 forks 품질 92 트렌드 38MIT

Repository Install

surendranb/google-analytics-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

surendranb/google-analytics-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

Google Analytics 4용 모델 컨텍스트 프로토콜(MCP) 서버: 실시간 쿼리 탐색, 스키마 발견, 메트릭 집계, AI 에이전트를 위한 청중 인사이트.

🌐 실시간 문서 및 웹 포털: https://ga4.builditwithai.xyz

⚡ 퀵스타트

🤖 클라이언트 설정

A. 클로드 코드 (CLI)

B. 커서 및 구글 반중력 (`mcp.json`)

C. Claude 데스크탑 (`claude_desktop_config.json`)

D. VS 코드 (클라인 / 루 코드 / 계속)

🛠️ 도구 및 기능

도구명	매개변수	설명	반환 유형
`get_ga4_data`	`dimensions` (리스트), [`metrics` (리스트), `date_ranges` (리스트), `limit` (int)	자동 메트릭 총합과 서버 측 집계가 포함된 다차원 GA4 보고서를 실행합니다.	`JSON / Markdown`
`list_accounts`	(없음)	접근 가능한 모든 Google Analytics 계정과 권한 수준을 나열합니다.	`JSON`
`list_properties`	`account_id` (선택 사항)	계정에 연관된 모든 GA4 속성을 나열합니다.	`JSON`
`get_property_metadata`	`property_id` (선택 사항)	완전한 차원 및 메트릭 스키마, 사용자 정의, 호환성 규칙을 가져옵니다.	`JSON`

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Google Analytics 4 (GA4) MCP Server 📊

Model Context Protocol (MCP) server for Google Analytics 4: real-time query exploration, schema discovery, metric aggregation, and audience insights for AI agents.

🌐 Live Documentation & Web Portal: https://ga4mcp.com/

⚡ Quickstart

# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://ga4.builditwithai.xyz/install" | bash

# Or run directly via your preferred runtime:
uvx google-analytics-mcp
uvx --from google-analytics-mcp ga4-mcp-server
python -m ga4_mcp
npx -y @surendranb/google-analytics-mcp

🤖 Client Setup

A. Claude Code (CLI)

claude mcp add google-analytics -- uvx google-analytics-mcp

B. Cursor & Google Antigravity (`mcp.json`)

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"]
    }
  }
}

C. Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"],
      "env": {
        "GA4_PROPERTY_ID": "your_ga4_property_id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
      }
    }
  }
}

D. VS Code (Cline / Roo Code / Continue)

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "@surendranb/google-analytics-mcp"]
    }
  }
}

🛠️ Tools & Capabilities

Tool Name	Parameters	Description	Return Type
`get_ga4_data`	`dimensions` (list), `metrics` (list), `date_ranges` (list), `limit` (int)	Runs multi-dimensional GA4 reports with automated metric totals and server-side aggregation.	`JSON / Markdown`
`list_accounts`	(none)	Lists all accessible Google Analytics accounts and permission levels.	`JSON`

GitHub에서 전체 README 보기

설치

uvx google-analytics-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"]
    }
  }
}