# NotebookLM MCP Server

NotebookLM의 기능을 MCP (Model Context Protocol)로 제공하는 서버입니다. AI 클라이언트(Claude Desktop, Cursor, Gemini CLI 등)에서 NotebookLM의 노트북 관리, 소스 추가 기능을 직접 사용할 수 있습니다.

## 주요 기능
- **노트북 목록 조회**: `list_notebooks`
- **노트북 생성**: `create_notebook`
- **웹 소스 추가**: `add_url_source`

## 설치 방법

### 1. Python 설치 필요
이 프로젝트를 실행하려면 **Python 3.10 이상**이 필요합니다.
[Python 공식 홈페이지](https://www.python.org/downloads/)에서 설치해 주세요. 설치 시 **"Add Python to PATH"** 옵션을 반드시 체크해야 합니다.

### 2. 패키지 설치
(권장) 가상환경을 생성하고 활성화한 후 설치하는 것이 좋습니다.
```bash
python -m venv .venv
.\.venv\Scripts\Activate.ps1  # Windows PowerShell
```

프로젝트 루트에서 다음 명령어를 실행합니다:

```bash
pip install .
```

실행 오류가 발생하면 `python -m pip install .` 또는 `uv pip install .`을 시도해 보세요.

## 실행 방법

설치가 완료되면 다음 명령어로 MCP 서버를 실행할 수 있습니다:

```bash
notebooklm-mcp
# 또는
python -m notebooklm_mcp
```

### AI 도구 연결 (Claude Desktop 예시)
`claude_desktop_config.json` 파일에 다음 설정을 추가하세요:

```json
{
  "mcpServers": {
    "notebooklm": {
      "command": "python",
      "args": ["-m", "notebooklm_mcp"]
    }
  }
}
```

## 상세 사용 가이드
더 자세한 실행 방법과 Claude/Cursor 연동 방법은 [docs/usage.md](docs/usage.md) 문서를 참고하세요.

## 주의사항
- **Chrome 로그인 필요**: 이 서버는 로컬 Chrome 브라우저의 쿠키를 사용하여 인증합니다. Chrome에서 Google 계정에 로그인된 상태여야 합니다.
- **쿠키 권한**: 브라우저 종료 후 사용하는 것을 권장하며, 쿠키 접근 권한 오류 시 관리자 권한으로 실행하거나 전체 디스크 접근 권한이 필요할 수 있습니다.