# YouTube MCP Server

Claude, Antigravity 등 AI 도구에서 YouTube 콘텐츠에 접근할 수 있는 MCP(Model Context Protocol) 서버입니다.

## 기능

| 도구 | 설명 | API 키 필요 |
|------|------|-------------|
| `get_transcript` | 자막/트랜스크립트 추출 | ❌ |
| `get_video_info` | 영상 메타데이터 조회 | ✅ |
| `get_channel_info` | 채널 정보 조회 | ✅ |
| `search_videos` | YouTube 검색 | ✅ |

## 설치

```bash
cd youtube-mcp
npm install
npm run build
```

## 환경 변수

모든 기능을 사용하려면 YouTube Data API v3 키가 필요합니다:

```bash
export YOUTUBE_API_KEY="your-api-key-here"
```

API 키가 없으면 `get_transcript` 기능만 사용 가능합니다.

## Claude Desktop 연동

`~/.config/claude/claude_desktop_config.json` 파일에 추가:

```json
{
  "mcpServers": {
    "youtube": {
      "command": "node",
      "args": ["/home/gim/projects/youtube-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

## Antigravity 연동

MCP 서버 설정에서 다음과 같이 추가:

```json
{
  "youtube-transcript": {
    "command": "node",
    "args": ["/home/gim/projects/youtube-mcp/build/index.js"],
    "env": {
      "YOUTUBE_API_KEY": "your-api-key-here"
    }
  }
}
```

## 사용 예시

### 자막 추출
```
get_transcript("https://youtube.com/watch?v=VIDEO_ID", "ko")
```

### 영상 정보 조회
```
get_video_info("https://youtube.com/watch?v=VIDEO_ID")
```

### 채널 정보 조회
```
get_channel_info("UCxxxxxx")
```

### YouTube 검색
```
search_videos("검색어", 10)
```

## 라이선스

MIT