mcpField
S
sourcebolt

sourcebolt

ローカル
github.com/candidloom-hubメモリ・ナレッジ01 週間前に更新
リポジトリ

sourcebolt について

sourceboltは、ユーザーのGoogleセッションを使ってAIアプリからGoogle NotebookLMのノートブックを操作する非公式MCPサーバーです。ノートブックやソースの管理、引用付きチャット、調査結果の取り込みに対応し、直接リクエストに失敗した場合はブラウザーでフォールバックします。

主な機能

  1. 01ノートブックの一覧・作成・更新
  2. 02ソースの追加・閲覧・管理
  3. 03引用付きのノートブックへの質問
  4. 04ウェブソースの調査と取り込み
  5. 05Studioコンテンツの生成とノート保存

活用シーン

  1. 01調査用ノートブックに記事を追加
  2. 02ノートブック内のソースに引用付きで質問
  3. 03新しい調査を探して選んだソースを取り込む

MCP 対応

ノートブック、ソース、チャット、調査などの操作をMCPクライアント向けのツールとして提供します。ローカルで動作し、ユーザーのGoogleセッションを使ってNotebookLMに接続します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "candidloom-hub-sourcebolt": {
      "command": "npx",
      "args": [
        "-y",
        "sourcebolt"
      ]
    }
  }
}
起動コマンドnpx -y sourcebolt

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmsourcebolt0.3.3
ocighcr.io/candidloom-hub/sourcebolt:0.3.3

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

sourcebolt

Release License: Apache-2.0

Google NotebookLM のノートブックを AI アシスタントで使えるようにします。インストールするものはほかに何もない、小さくて高速なプログラムです。

2 分でインストール

やりたいことこちらをご覧ください
すべてをインストールして接続するコマンドを 1 つ実行する以下の 2 つのコマンド
お使いの AI アプリ（Claude、Cursor、VS Code、Windsurf、Gemini CLI、ChatGPT）向けの図解に沿って進める手順ガイド
AI アプリにインストールを任せるAI にインストールを任せる
npm、Docker、または手動でセットアップする（開発者向け）インストールとAI アプリの接続

Windows（PowerShell を開き、貼り付けて Enter キーを押します）：

irm https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.ps1 | iex

macOS と Linux（ターミナルを開き、貼り付けて Enter キーを押します）：

curl -fsSL https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.sh | sh

インストーラーはダウンロードを検証し、ユーザー専用に sourcebolt をインストールしてから、sourcebolt setup の実行を提案します。セットアップでは AI アプリを検出し、選択したアプリを接続します（設定のバックアップを保存します）。その後、Google にサインインするためのブラウザーウィンドウが開きます。パスワードが送信されるのは Google だけです。

クイックスタート · インストール · アプリを接続 · ツール · FAQ · ドキュメント

独立したプロジェクトです。 sourcebolt は Google によって開発、推奨、または後援されていません。「NotebookLM」は Google LLC の商標です。NotebookLM には個人アカウント向けの公開 API がないため、sourcebolt は NotebookLM のウェブサイトと同じ内部ウェブ呼び出しを使用します。利用を決める前に制限とリスクをお読みください。

できること

sourcebolt は MCP サーバーです。MCP（Model Context Protocol）は、Claude、Cursor、VS Code、Codex などの AI アプリが外部ツールを呼び出すための標準規格です。sourcebolt を接続すると、アシスタントに次のようなことを頼めます。

  • 「NotebookLM のノートブックを一覧表示して。」
  • 「この 3 つの記事を Thesis ノートブックに追加して。」
  • 「引用付きで、サンプルサイズについて情報源が述べていることを Thesis ノートブックに質問して。」
  • 「バッテリーのリサイクルに関する最近の研究を調べて、最適な情報源をインポートして。」

アシスタントが sourcebolt を呼び出し、sourcebolt がユーザー自身の Google セッションを使って NotebookLM と通信します。回答には、情報源からの引用が含まれます。

主な数値

GitHub Actions ランナー（2 CPU、AMD EPYC 7763）で v0.2.0 を測定した中央値です。測定方法と生データ：bench/RESULTS.mdおよびdocs/performance.md。

項目結果
起動時間（起動から準備完了まで）8.2 ms
プログラムのサイズ約 10 MB、ファイル 1 つ
アイドル時のメモリ使用量16.2 MB
sourcebolt 自身の 1 回の呼び出しあたりの処理時間（ノートブック 100 件、キャッシュあり／なし）0.40 ms / 0.76 ms
チャット：Google から最初のチャンクを受信してから最初の進捗を表示するまで+0.3 ms
Google への実際の notebook_list 呼び出し中央値 848 ms（主に Google 側の処理時間。ノート PC 1 台、2026-10-14）

クイックスタート

  1. インストールします。 お使いのシステム用のファイルを最新リリースからダウンロードし、sourcebolt を PATH に配置します。手順ごとのコマンドはインストールにあります。

  2. サインインします。 デバッグポートを指定して Brave または Chrome を起動し、そのウィンドウで NotebookLM にサインインしてから、次を実行します。

    sourcebolt login --attach http://127.0.0.1:9222

    Saved profile "default" for notebook.google.com (N notebooks visible). と表示されます。各システムでのブラウザーコマンドは docs/auth.md にあります。v0.2.0 以降のリリースでは、sourcebolt setup を実行すると手順 2〜4 が自動で行われます（docs/getting-started.md）。

  3. 確認します。

    sourcebolt doctor

    各行が ok で始まっていることを確認してください。

  4. AI アプリに接続します。 Claude Code の場合：

    claude mcp add sourcebolt -- sourcebolt serve

    v0.2.0 以降では、代わりに Claude Code プラグインをインストールできます。プラグインを使うと、サーバーと sourcebolt スキルが追加されます（プログラムは引き続き PATH に配置する必要があります）。

    /plugin install sourcebolt --marketplace candidloom-hub/sourcebolt

    その他のアプリについては、AI アプリに接続するをご覧ください。ワンクリックインストールリンクは docs/install-links.md にあります。

  5. 質問します。 アプリで次のように入力します：「sourcebolt を使って NotebookLM のノートブックを一覧表示し、最初のノートブックに引用付きで 1 段落の要約を依頼してください。」

期待される出力を含む詳細な手順は docs/getting-started.md にあります。

インストール

現在のリリースは v0.3.3 です。どの方法を選べばよいかわからない場合は、docs/install.md をご覧ください。または、1 行のインストーラーをご利用ください（ダウンロードのチェックサムを検証し、管理者権限は不要です。-Uninstall / --uninstall でアンインストールできます）。

irm https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.ps1 | iex   # Windows PowerShell

curl -fsSL https://raw.githubusercontent.com/candidloom-hub/sourcebolt/main/install.sh | sh   # macOS, Linux

Cline などの AI エージェント経由でインストールしますか？llms-install.md を参照してください。エージェント向けの手順が記載されていますが、Google へのサインインはご自身で行う必要があります。

チャネル状況方法
GitHub リリースバイナリ利用可能x64 および ARM64 の Windows、macOS、Linux に対応しています。以下をご覧ください。
go install利用可能Go 1.27 以降が必要です。
Docker（GHCR）利用可能ghcr.io/candidloom-hub/sourcebolt:0.3.3。イメージにはバージョンタグのみが付与されており、latest タグはありません。
npm（npx）利用可能npx -y sourcebolt serve（Node.js 18 以降が必要です）。アプリの MCP 設定では、コマンドに npx、引数に ["-y", "sourcebolt", "serve"] を指定します。
PyPI（pipx、uvx）まだ公開されていません
リリースバイナリ

Windows（PowerShell）。 sourcebolt.exe をユーザープロファイル内のフォルダーに配置し、そのフォルダーを PATH に追加します。ARM64 PC の場合は、amd64 を arm64 に置き換えてください。

$dir = "$env:LOCALAPPDATA\Programs\sourcebolt"
New-Item -ItemType Directory -Force $dir | Out-Null
Invoke-WebRequest https://github.com/candidloom-hub/sourcebolt/releases/download/v0.3.3/sourcebolt_0.3.3_windows_amd64.zip -OutFile "$env:TEMP\sourcebolt.zip"
Expand-Archive "$env:TEMP\sourcebolt.zip" -DestinationPath $dir -Force
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$dir", "User")

新しいターミナルを開いてから、sourcebolt --version を実行します。sourcebolt 0.3.3 と表示されます。

macOS と Linux（bash）。 OS に darwin または linux を、ARCH に amd64 または arm64 を設定します。

OS=linux ARCH=amd64
curl -fsSLO "https://github.com/candidloom-hub/sourcebolt/releases/download/v0.3.3/sourcebolt_0.3.3_${OS}_${ARCH}.tar.gz"
tar -xzf "sourcebolt_0.3.3_${OS}_${ARCH}.tar.gz" sourcebolt
mkdir -p ~/.local/bin && mv sourcebolt ~/.local/bin/
sourcebolt --version

sourcebolt が見つからない場合は、~/.local/bin を PATH に追加してください。各リリースには、鍵不要の cosign 署名を含む checksums.txt と、アーカイブごとの CycloneDX SBOM（ソフトウェア部品表）が用意されています。確認方法は docs/security.md をご覧ください。

Go
go install github.com/candidloom-hub/sourcebolt/cmd/sourcebolt@latest
Docker
docker run -i --rm -v sourcebolt-config:/config ghcr.io/candidloom-hub/sourcebolt:0.3.3

イメージには OS のキーリングがないため、プロファイルキーは /config ボリューム内のファイルに保存されます。このボリュームはパスワードと同様に保護してください。0.2.0-browser タグには、フォールバック経路用のブラウザーが追加されています。コンテナー内でサインインする方法は docs/auth.md をご覧ください。

AI アプリを接続する

まずサインインしてください。どのアプリでも、起動するコマンドは同じです：sourcebolt serve。sourcebolt が PATH にない場合は、代わりにプログラムのフルパスを使用してください（たとえば Windows では、JSON 内で C:\\Users\\you\\AppData\\Local\\Programs\\sourcebolt\\sourcebolt.exe を指定します）。

アプリローカルで動作しますか？設定
Claude Codeはいclaude mcp add sourcebolt -- sourcebolt serve、または v0.2.0 以降ではプラグインを使用：/plugin install sourcebolt --marketplace candidloom-hub/sourcebolt
Claude Desktopはいclaude_desktop_config.json に追加します（下記）
Cursorはい~/.cursor/mcp.json に追加します（下記）
VS Code（Copilot エージェントモード）はいcode --add-mcp '{"name":"sourcebolt","type":"stdio","command":"sourcebolt","args":["serve"]}'
Windsurfはいmcp_config.json に追加します（下記）
Codex CLI と IDEはいcodex mcp add sourcebolt -- sourcebolt serve
Gemini CLIはいgemini mcp add -s user sourcebolt sourcebolt serve
ChatGPT デスクトップアプリはい、ローカル（STDIO）サーバーとして設定、MCP サーバー。Codex の設定を共有します
ChatGPT ウェブ版いいえパブリックな HTTPS サーバーが必要です。sourcebolt は設計上、お使いのコンピューター上でのみ動作します。

Claude Desktop、Cursor、Windsurf で使用する JSON 形式：

{
  "mcpServers": {
    "sourcebolt": { "command": "sourcebolt", "args": ["serve"] }
  }
}

ファイルの場所、VS Code の JSON、Codex の TOML、HTTP モード、テスト済みの設定例については、docs/clients.md を参照してください。

ツールの使用枠が少ない場合は、args に "--tools", "minimal" を追加すると、8 つのコアツールのみが公開されます。

アシスタントでできること

タスク別に分類しています。各ツール、オプション、状態については、生成されたリファレンス docs/tools.md を参照してください。

タスクツール
ノートブックを検索して開くnotebook_list、notebook_open、notebook_create、notebook_update
ソース（ウェブページ、YouTube、貼り付けたテキスト）を追加して読むsource_add、source_list、source_read、source_update
引用付きで質問するchat_ask、chat_status、chat_history、chat_configure、suggest
ウェブで新しいソースを検索するresearch_start、research_status、research_import
メモを残すnote_list、note_save
Studio（音声、レポート、フラッシュカードなど）studio_list、studio_generate
共有、ラベル、アカウントshare_status、share_update、label_list、label_update、account_settings
整理するdelete（常に事前確認を表示）、job_cancel

一部のオプションはまだ利用できません。たとえば、Drive とファイルのアップロード、Studio のオプション値については、ライブキャプチャで確認できていません。これらは失敗を黙って無視するのではなく、明確な UNSUPPORTED_BY_TRANSPORT エラーを返します。SKILL.md では、どのツールを使うべきかをエージェントに案内しています。

仕組み

  1. まず直接呼び出します。 sourcebolt は、NotebookLM 独自の内部ウェブリクエスト（RPC、リモートプロシージャコールと呼ばれます）を、セッション Cookie を使って HTTP/2 経由で送信します。これが最速の方法です。
  2. ブラウザーにフォールバックします。 Google が直接のリクエストを拒否した場合、sourcebolt は別のプロファイルにあるヘッドレス Chrome 系ブラウザー内でリクエストを再試行できます。Brave、Chrome、Edge のいずれかがインストールされている必要があります（または -browser Docker イメージを使用します）。
  3. ページにフォールバックします。 Google がチャットまたはソース追加リクエストの形式を変更した場合、sourcebolt は NotebookLM のページ自体に入力し、回答を読み取ることができます（操作するページ構造にちなんで「DOM」フォールバックと呼ばれます）。

--no-browser-fallback を指定すると、ブラウザーを使うフォールバックを無効にできます。server_info では、直近の呼び出しに使用された方法を確認できます。詳細は docs/auth.md を参照してください。

FAQ

これはGoogleの公式製品ですか？ いいえ。独立したオープンソースプロジェクトです。

sourceboltは私のGoogleパスワードを確認しますか？ いいえ。通常のブラウザーウィンドウで、ご自身でサインインします。sourceboltが保持するのは、ディスク上で暗号化されたセッションCookieのみです。

AIは私のCookieを読み取れますか？ いいえ。Cookieやパスワードを受け取ったり返したりするツールはありません。サインインはコマンドラインからのみ行えます。

データはほかの場所にも送信されますか？ いいえ。NotebookLMとのみ通信します。ソースとして追加したURLは、お使いのコンピューターではなくGoogleによって取得されます。

無料ですか？ はい。Apache-2.0で、有料プランはありません。

詳しくは、docs/faq.mdをご覧ください。問題が発生しましたか？ docs/troubleshooting.mdをご覧ください。

制限とリスク

  • 非公式です。 GoogleはNotebookLMの内部呼び出しをいつでも変更できます。sourceboltが更新されるまで、ツールが動作しなくなる可能性があります。
  • 利用規約。 セッションを使ってGoogleのウェブアプリを自動化すると、Googleの利用規約に違反し、レート制限やアカウントへの措置につながる可能性があります。sourceboltは自己責任でご利用ください。保証はありません（ライセンスをご覧ください）。
  • Googleのクォータが適用されます。 ノートブック、ソース、チャット、Studioの制限は、アカウントごとにGoogleが設定します。sourceboltは制限をエラーとして報告し、回避しません。
  • まずは安全にお試しください。 評価中は、公開コンテンツを使ったテスト用ノートブックをご利用ください。

ドキュメント

docs/index.mdから始めてください。主なドキュメント：

貢献

バグ報告やプルリクエストは、GitHub Issuesで歓迎しています。投稿する前に、以下をご確認ください。

  • sourcebolt --versionとsourcebolt doctorを実行し、出力を添えてください。先にCookieやトークンを削除してください。
  • コードを変更する場合は、go vet ./...とgo test ./...を実行してください。
  • docs/tools.mdは自動生成されます。コード内のツール説明を変更し、go run ./tools/gendocs > docs/tools.mdを実行してください。
  • セキュリティ上の問題は、docs/security.mdの説明に従って、非公開で報告してください。

ライセンス

Apache-2.0。LICENSEとNOTICEをご覧ください。

クレジット

sourceboltはゼロから作成されました。他プロジェクトのソースコードはコピーしていません。NotebookLMのワイヤーフォーマットの設計と知見は、以下のMITまたはApache-2.0ライセンスのプロジェクトから学びました。感謝いたします（NOTICEとresearch/notes/をご覧ください）。ライセンスがないプロジェクトやコピーレフトライセンスのプロジェクトは、動作の調査のみを目的に参照し、そこから得たものは使用していません。

プロジェクトライセンス参考にした内容
teng-lin/notebooklm-pyMITRPC ID、ペイロードの構成、ソースとチャットのフロー
tmc/nlmMITGoでのワイヤープロトコルのモデリングと、情報を損なわない往復テスト
jacob-bd/gemini-notebook-mcp-cliMITMCPツールの提供範囲、内部APIのリファレンス
LocalKinAI/notebooklm-goApache-2.0Goクライアントと認証フローのアイデア

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。