YouTube Studio & Channel Analytics MCP Server

YouTube Studio 및 채널 인텔리전스를 위한 프로덕션급 Model Context Protocol(MCP) 서버

AI 어시스턴트(Claude, Cursor, Antigravity 등)가 YouTube 채널을 분석하고, 동영상 지표를 추적하고, YouTube Studio 분석을 심층 분석하며, 시청자 트래픽 소스를 파악하고, 커뮤니티 정서를 분석할 수 있도록 지원합니다 — 전적으로 .env를 통해 구성됩니다.

🚀 기능 및 MCP 도구 모음

YouTube Studio MCP는 8가지 특화 도구를 제공합니다:

Related MCP server: YouTube MCP Server

⚙️ 환경 구성(.env)

모든 자격 증명과 설정은 .env에서 직접 읽어옵니다:

# Google OAuth 2.0 Credentials (from Google Cloud Console)
YOUTUBE_CLIENT_ID=your_client_id.apps.googleusercontent.com
YOUTUBE_CLIENT_SECRET=your_client_secret

# OAuth Refresh Token (written automatically by run_auth.py)
YOUTUBE_REFRESH_TOKEN=

🛠️ 단계별 설정 가이드

1. uv로 저장소 복제 및 의존성 설치

git clone https://github.com/Dhananjayrbiraris/youtube-mcp.git
cd youtube-mcp

uv venv
uv pip install -e .

2. Google Cloud 프로젝트 설정(1회)

1. Google Cloud Console을 엽니다.

2. 새 프로젝트를 생성합니다(예: YouTube-Studio-MCP).

3. **API 및 서비스(APIs & Services) > 라이브러리(Library)**에서 다음을 사용 설정합니다:

   • YouTube Data API v3

   • YouTube Analytics API

4. **OAuth 동의 화면(OAuth consent screen)**에서:

   • 사용자 유형: 외부(External) -> 앱 이름과 본인의 이메일을 입력합니다.

   • **테스트 사용자(Test users)**에 본인의 Google 이메일 주소를 추가합니다.

5. **사용자 인증 정보(Credentials)**에서:

   • **사용자 인증 정보 만들기(Create Credentials) > OAuth 클라이언트 ID(OAuth client ID)**를 클릭합니다.

   • 애플리케이션 유형: 데스크톱 앱(Desktop App).

   • **클라이언트 ID(Client ID)**와 **클라이언트 보안 비밀번호(Client Secret)**를 복사합니다.

6. 이를 .env에 붙여넣습니다:

   YOUTUBE_CLIENT_ID=123456789-xxxx.apps.googleusercontent.com
   YOUTUBE_CLIENT_SECRET=GOCSPX-xxxx

3. 원클릭 인증 도구 실행

uv run run_auth.py

브라우저에서 원클릭 Google OAuth 로그인이 실행됩니다. 그러면 **YOUTUBE_REFRESH_TOKEN**이 .env 파일에 자동으로 기록됩니다.

4. AI 클라이언트에 연결

Claude Desktop

claude_desktop_config.json에 다음을 추가합니다:

{
  "mcpServers": {
    "youtube-studio": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/youtube-mcp",
        "run",
        "youtube-studio-mcp"
      ]
    }
  }
}

💡 AI 프롬프트 예시

• "지난 28일 동안 내 YouTube 채널의 성과 개요를 알려줘."

• "내 트래픽은 대부분 어디에서 오고 있나요(검색, 추천 동영상 또는 탐색 기능)?"

• "이번 달에 가장 많은 구독자를 확보한 동영상은 무엇인가요?"

• "내 최신 동영상 댓글에서 공통된 주제와 질문을 요약해 줘."

• "연령대 및 국가별 시청자 구성을 보여줘."

🧪 테스트

테스트 스위트를 실행합니다:

pytest

📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.