hucompany

Основные функции

Related MCP server: NotebookLM MCP Server

Важное уведомление

Этот MCP использует следующие внутренние API:

• Не документированы и могут изменяться без предупреждения.

• Требуется извлечение куки из браузера.

Пожалуйста, используйте только в личных/экспериментальных целях.

Установка

Вы можете установить notebooklm-mcp-server из PyPI с помощью предпочитаемого менеджера пакетов Python (uv, pip, pipx и т.д.).

Также поддерживается установка непосредственно из исходного кода.

Обновление

Обновите до последней версии, используя команду обновления вашего менеджера пакетов.

После обновления необходимо перезапустить AI-инструмент, чтобы обновить соединение:

• Claude Code: перезапустите приложение или используйте команду переподключения

• Cursor: перезапустите приложение

• Gemini CLI: перезапустите сеанс CLI

Удаление

Чтобы полностью удалить MCP, используйте команду удаления вашего менеджера пакетов. При желании вы также можете удалить его из кэшированных токенов аутентификации или файлов конфигурации AI-инструмента.

Аутентификация

Перед использованием MCP требуется аутентификация NotebookLM.

Рекомендуется автоматический режим. При запуске отдельного профиля Chrome и входе в Google куки извлекаются автоматически. Данные входа сохраняются для последующего обновления аутентификации.

Если автоматический режим не работает, вы можете вручную извлечь и сохранить куки в Chrome DevTools с помощью файлового режима.

После успешной аутентификации добавьте MCP в AI-инструмент и перезапустите его.

Подробности и устранение неполадок см. в **docs/AUTHENTICATION.md**.

Настройка MCP

⚠️ Внимание к контекстному окну (Context Window): этот MCP предоставляет 31 инструмент и может занимать много места в контекстном окне. Если вы не используете NotebookLM активно, рекомендуется отключать MCP, чтобы освободить контекст для других задач.

Параметры CLI

Сервер можно настроить с помощью аргументов командной строки. Можно задать транспортный протокол (stdio, http, sse), порт, хост, режим отладки, тайм-аут запросов и т.д.

Переменные окружения

Настройка также возможна через переменные окружения. (NOTEBOOKLM_MCP_TRANSPORT, NOTEBOOKLM_MCP_PORT и т.д.)

Подключение AI-инструментов (Claude Code, Gemini CLI, IDE и т.д.)

Такие инструменты, как Claude Code или Gemini CLI, позволяют легко добавлять MCP-сервер с помощью встроенных команд.

Для инструментов, использующих JSON-файлы конфигурации, таких как Cursor, VS Code, Claude Desktop, необходимо найти путь к установленному notebooklm-mcp и добавить его в элемент mcpServers файла конфигурации.

Примеры использования

Вы можете использовать MCP следующим образом, общаясь на естественном языке с AI-инструментами, такими как Claude Code, Cursor, Gemini CLI.

Исследование и поиск

• "Покажи список всех моих ноутбуков NotebookLM"

• "Создай новый ноутбук под названием 'Исследование AI-стратегий'."

• "Начни веб-исследование по теме 'Корпоративные показатели ROI в AI' и покажи найденные источники"

• "Проведи углублённое исследование по теме 'Тренды облачных маркетплейсов' и принеси 10 лучших источников"

• "Найди в моём Google Drive документы, связанные с 'дорожной картой продукта', и создай ноутбук"

Добавление контента

• "Добавь этот URL в мой ноутбук: https://example.com/article"

• "Добавь это видео YouTube о Kubernetes в ноутбук"

• "Добавь мои заметки с встречи как текстовый источник в этот ноутбук"

• "Импортируй этот документ Google в мой исследовательский ноутбук"

Анализ на основе AI

• "Каковы ключевые выводы этого ноутбука?"

• "Суммируй основные утверждения всех этих источников"

• "Что в этом источнике говорится о лучших практиках безопасности?"

• "Сделай AI-саммари того, о чём этот ноутбук"

• "Измени настройки чата на стиль учебного руководства и сделай ответы более развёрнутыми"

Создание контента

• "Создай из этого ноутбука аудиоподкаст-обзор в формате углублённого анализа"

• "Создай видеообзор в классическом визуальном стиле"

• "Создай брифинг-документ на основе этих источников"

• "Создай flashcards для учёбы со средним уровнем сложности"

• "Создай инфографику в горизонтальной ориентации"

• "Нарисуй ментальную карту по моим исследовательским источникам"

• "Создай презентационную слайд-колоду из этого ноутбука"

Умное управление

• "Проверь источники Google Drive, требующие обновления, и синхронизируй их"

• "Покажи все источники этого ноутбука и их актуальность"

• "Удали этот источник из ноутбука"

• "Проверь статус создания моего аудиообзора"

Жизненный цикл аутентификации

• Куки: действуют около 2~4 недель (при наличии сохранённого профиля автоматически обновляются через headless Chrome)

• CSRF-токен: действует около нескольких минут (автоматически обновляется при сбое запроса)

• ID сеанса: действует в течение сеанса MCP (автоматически извлекается при запуске MCP)

v0.1.9+: сервер автоматически обрабатывает истечение срока действия токенов.

1. Немедленное обновление CSRF-токена по истечении срока

2. Повторная загрузка куки с диска, если они были обновлены извне

3. Запуск аутентификации в headless Chrome при наличии сохранённого профиля входа

Если автоматическое обновление не удалось (например, при полном истечении срока входа в Google), необходимо снова запустить инструмент аутентификации.

Устранение неполадок

Если обновление не выполняется должным образом

Из-за проблем с кэшем менеджера пакетов или ограничений версий последняя версия может не установиться. В этом случае проблему можно решить, используя опцию принудительной переустановки.

Если Chrome DevTools MCP не работает (Cursor/Gemini CLI)

Если Chrome DevTools MCP отображается как «нет инструментов» или не запускается, это может быть известная ошибка npx. В этом случае может помочь изменение настроек для запуска с помощью pnpm.

Ограничения

• Лимит скорости: бесплатный тариф ограничен примерно 50 запросами в день.

• Нет официальной поддержки: API может изменяться без предупреждения.

• Истечение срока куки: возможно, потребуется повторно извлекать куки каждые несколько недель.

Вклад в проект

О документации API и способах добавления новых функций см. CLAUDE.md.

Лицензия

MIT License