NotebookLM MCP

Краткое назначение

NotebookLM MCP — dual-mode MCP-сервер для работы с NotebookLM через web-режим и Enterprise REST API.

Бизнес-задача

Исследовательские рабочие процессы в NotebookLM включают создание notebooks, добавление источников, запросы к материалам, заметки, аудиообзоры и экспорт артефактов. Проект превращает эти действия в инструменты для AI-ассистентов и автоматизируемых сценариев.

Техническое решение

Сервер поддерживает два backend-режима. web использует текущую web-сессию NotebookLM и cookie/profile storage. enterprise работает с Google Cloud NotebookLM Enterprise API и Podcast API. Режим выбирается через NOTEBOOKLM_MODE.

Архитектура

• Python MCP server;
• mode router web / enterprise;
• auth layer для cookies, ADC, service account или gcloud token;
• tools для notebooks, sources, notes, research, studio artifacts и audio overview;
• конфигурация через environment variables;
• logging с защитой от утечки cookie/token/session и больших payloads.

Стек

Python 3.10+, FastMCP, httpx, Pydantic, pydantic-settings, aiofiles, google-auth, NotebookLM, Google Cloud APIs.

Интеграции

• NotebookLM web app;
• NotebookLM Enterprise / Gemini Enterprise;
• Google Cloud auth;
• Google Drive / YouTube / URL / text / file sources;
• MCP-compatible clients.

Ограничения и риски

web-режим не является официальным публичным API Google и зависит от поведения web-приложения. Enterprise-возможности требуют соответствующего доступа в Google Cloud.

Что показывает в портфолио

Сложную AI/research-интеграцию, аккуратную работу с разными режимами авторизации, проектирование MCP tool surface и честное разделение official/unofficial API-путей.