Youtuber MCP Claude

youtuber-mcp-claude

MCP (Model Context Protocol) Server สำหรับจัดการช่อง YouTube ผ่าน Claude Code

ใช้ YouTube Data API v3 และ YouTube Analytics API เพื่อให้ Claude สามารถจัดการวิดีโอ วิเคราะห์ข้อมูล ทำ SEO และวางแผน content ได้

รันเป็น Docker container (Streamable HTTP mode) แล้วเชื่อมต่อกับ Claude Code ผ่าน .mcp.json

Features

Total: 32 tools

Prerequisites

• Docker & Docker Compose
• Google Cloud Project with YouTube Data API v3 and YouTube Analytics API enabled
• OAuth 2.0 credentials

Quick Start (Docker)

cd youtuber-mcp-claude

# 1. ตั้งค่า environment
cp .env.example .env
# แก้ไข .env ใส่ GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

# 2. Setup OAuth (ครั้งแรก - ต้อง npm install ก่อน)
npm install --ignore-scripts
npm run setup-oauth
# จะเปิด browser ให้ authorize แล้วบันทึก refresh token ลง .env

# 3. Build & Run Docker
docker compose up -d --build

# 4. ตรวจสอบ
curl http://localhost:3030/health

เชื่อมต่อกับ Claude Code

ไฟล์ .mcp.json ถูกตั้งค่าไว้แล้ว:

{
  "mcpServers": {
    "youtuber": {
      "url": "http://localhost:3030/mcp"
    }
  }
}

เมื่อเปิด Claude Code ใน directory นี้ จะเชื่อมต่อ MCP server อัตโนมัติ

Manual Installation (ไม่ใช้ Docker)

npm install --ignore-scripts
cp .env.example .env
npm run setup-oauth
npm run build
npm start  # stdio mode

Google Cloud Setup

1. Go to Google Cloud Console
2. Create a new project or select existing
3. Enable APIs:

- YouTube Data API v3 - YouTube Analytics API

1. Go to Credentials > Create Credentials > OAuth 2.0 Client ID
2. Application type: Web application (or Desktop)
3. Authorized redirect URI: http://localhost:3000/oauth/callback
4. Copy Client ID and Client Secret to .env

OAuth Setup

npm run setup-oauth

This will:

1. Open a browser for Google authorization
2. Start a local HTTP server to receive the callback
3. Exchange the authorization code for tokens
4. Save the refresh token to .env

Required Scopes

• youtube - Manage YouTube account
• youtube.upload - Upload videos
• youtube.force-ssl - Manage comments
• yt-analytics.readonly - View analytics
• yt-analytics-monetary.readonly - View revenue reports

Configuration

Docker Compose

# Start
docker compose up -d --build

# Stop
docker compose down

# Logs
docker compose logs -f youtuber-mcp

# Rebuild
docker compose up -d --build --force-recreate

Port: 3030 (host) -> 3000 (container)

Environment Variables

Tool Usage Examples

Video Management

"Upload my video at /path/to/video.mp4 with title 'My Tutorial'"
"List my recent videos"
"Update the description of video dQw4w9WgXcQ"
"Set thumbnail for my latest video"

Analytics

"Show my channel stats"
"What's the performance of my latest video?"
"Show audience demographics for the last 90 days"
"What are my top 5 videos by watch time?"
"Show my revenue report for the last 30 days"

SEO

"Suggest titles for a video about 'Python tutorials'"
"Generate a description for my cooking video"
"Suggest tags based on my competitors' videos"
"Generate chapters from this transcript"

Content Research

"What's trending in the gaming category in Thailand?"
"Analyze the channel UCxxxxxx"
"Search for videos about 'machine learning'"

Content Calendar

"Add a content plan: 'React Tutorial' for next Monday"
"Show all my content plans"
"Update plan #3 status to 'filming'"
"What content is planned for this week?"

API Quota Usage

YouTube Data API has a daily quota of 10,000 units (default). Key costs:

Use get_quota_status to check remaining quota.

Tech Stack

• Runtime: Node.js 18+
• Language: TypeScript 5+ (strict mode)
• MCP SDK: @modelcontextprotocol/sdk
• YouTube API: googleapis
• Database: better-sqlite3 (cache & content calendar)
• Validation: zod
• Auth: Google OAuth 2.0

Project Structure

src/
├── index.ts                    # MCP server entry point (stdio)
├── server-sse.ts               # MCP server Streamable HTTP mode (Docker)
├── config.ts                   # Configuration
├── tools/
│   ├── index.ts                # Tool registry & dispatcher (32 tools)
│   ├── video-management.ts     # Upload, update, delete, list, thumbnail
│   ├── channel-analytics.ts    # Stats, performance, audience, revenue
│   ├── seo-optimization.ts     # Titles, descriptions, tags, chapters
│   ├── content-research.ts     # Trending, competitor, search
│   ├── playlist-management.ts  # Create, add, list, reorder
│   ├── comment-management.ts   # Get, reply, delete, summarize
│   ├── community-post.ts       # Community post guidance
│   └── content-calendar.ts     # SQLite-based content planning
├── services/
│   ├── auth.ts                 # Google OAuth 2.0
│   ├── youtube-api.ts          # YouTube Data API v3 wrapper
│   ├── youtube-analytics.ts    # YouTube Analytics API wrapper
│   └── cache.ts                # SQLite cache with TTL
├── types/
│   ├── youtube.ts              # YouTube type definitions
│   └── tools.ts                # Tool type definitions
└── utils/
    ├── helpers.ts              # URL parsing, date formatting
    ├── rate-limiter.ts         # API quota management
    └── logger.ts               # Logging (stderr)

License

MIT