Bookmark MCP

April 10, 2025 · View on GitHub

Chrome ブックマークを管理するための MCP (Machine Control Protocol) 拡張機能です。
Chrome bookmark management extension using MCP (Machine Control Protocol).

概要 / Overview

このプロジェクトは、LLMからChrome ブックマークを操作するためのMCPツールです。
This project is an MCP tool for manipulating Chrome bookmarks from LLM.

ScreenShot

コンポーネント構成：

Components:

  1. Chrome拡張機能 / Chrome Extension

    • Chromeのブックマークを操作するための拡張機能
    • Extension to manipulate Chrome bookmarks
    • extension/ ディレクトリに配置
    • Located in the extension/ directory

  2. MCPサーバー / MCP Server

    • LLMからの標準入出力でブックマーク操作のコマンドを処理
    • Processes bookmark operation commands via stdin/stdout from LLM
    • server/ ディレクトリに配置
    • Located in the server/ directory

インストール / Installation

拡張機能のインストール / Extension Installation

  1. Chrome で chrome://extensions を開く
    Open chrome://extensions in Chrome

  2. デベロッパーモードを有効にする
    Enable Developer Mode

  3. extension フォルダを「パッケージ化されていない拡張機能を読み込む」で読み込む
    Load the extension folder using "Load unpacked"

MCPツールの登録 / MCP Tool Registration

  1. Cursorの設定を開く
    Open Cursor settings

  2. MCPツールの設定セクションに移動
    Navigate to MCP tools section

  3. 以下の設定をMCP設定ファイル（~/.cursor/mcp.json）に追加：
    Add the following settings to the MCP configuration file (~/.cursor/mcp.json):

    {
  "mcpServers": {
    "bookmark-mcp": {
      "protocol": "stdio",
      "command": "node",
      "args": [
        "<プロジェクトパス>/server/dist/index.js"
      ],
      "cwd": "<プロジェクトパス>",
      "description": "Bookmark MCP Server (Stdio)"
    }
  }
}

    注: <プロジェクトパス> は実際のプロジェクトのパスに置き換えてください。
    Note: Replace <プロジェクトパス> with the actual project path.

利用可能なコマンド / Available Commands

LLMから以下のコマンドを使用してブックマークを操作できます：
The following commands are available for bookmark manipulation from LLM:

ブックマークツリー全体を取得 / Get Entire Bookmark Tree

mcp_bookmark_get_tree()

ブックマークの検索 / Search Bookmarks

mcp_bookmark_search({
    query: "<検索キーワード>"  // タイトルやURLで検索 / Search by title or URL
})

新しいブックマークを追加 / Add New Bookmark

mcp_bookmark_add({
    parentId: "<フォルダID>",  // 追加位置の親フォルダID / Parent folder ID
    title: "<タイトル>",      // ブックマークのタイトル / Bookmark title
    url: "<URL>",            // ブックマークのURL / Bookmark URL
    index: 0                 // [オプション] 追加位置のインデックス / [Optional] Index position
})

指定したIDのブックマークを取得 / Get Bookmark by ID

mcp_bookmark_get({
    id: "<ブックマークID>"  // 取得するブックマークのID / ID of the bookmark to get
})

ブックマークの更新 / Update Bookmark

mcp_bookmark_update({
    id: "<ブックマークID>",  // 更新するブックマークのID / ID of the bookmark to update
    changes: {
        title: "<新しいタイトル>",  // [オプション] 新しいタイトル / [Optional] New title
        url: "<新しいURL>"        // [オプション] 新しいURL / [Optional] New URL
    }
})

ブックマークの削除 / Remove Bookmark

// 単一のブックマークを削除 / Remove a single bookmark
mcp_bookmark_remove({
    id: "<ブックマークID>"  // 削除するブックマークのID / ID of the bookmark to remove
})

// 複数のブックマークを削除 / Remove multiple bookmarks
mcp_bookmark_remove({
    id: ["<ブックマークID1>", "<ブックマークID2>", ...]  // 削除するブックマークIDの配列 / Array of bookmark IDs to remove
})

ブックマークツリーの削除 / Remove Bookmark Tree

mcp_bookmark_remove_tree({
    id: "<ブックマークID>"  // 削除するブックマークツリーのID / ID of the bookmark tree to remove
})

新しいフォルダを作成 / Create New Folder

mcp_bookmark_create_folder({
    parentId: "<親フォルダID>",  // 作成位置の親フォルダID / Parent folder ID
    title: "<フォルダ名>",      // フォルダ名 / Folder name
    index: 0                   // [オプション] 作成位置のインデックス / [Optional] Index position
})

ブックマークの移動 / Move Bookmarks

mcp_bookmark_move({
    items: [
        {
            id: "<ブックマークID1>",     // 移動するブックマークのID / ID of the bookmark to move
            parentId: "<フォルダID1>",   // 移動先の親フォルダID / Destination parent folder ID
            index: 0                    // [オプション] 移動先のインデックス / [Optional] Destination index
        },
        {
            id: "<ブックマークID2>",
            parentId: "<フォルダID2>"    // 別のフォルダに移動可能 / Can move to different folders
        }
    ]
})

ブックマークのコピー / Copy Bookmarks

mcp_bookmark_copy({
    items: [
        {
            sourceId: "<ブックマークID1>",    // コピー元のブックマークID / Source bookmark ID
            parentId: "<フォルダID1>",      // コピー先の親フォルダID / Destination parent folder ID
            index: 0                       // [オプション] コピー先のインデックス / [Optional] Destination index
        },
        {
            sourceId: "<ブックマークID2>",
            parentId: "<フォルダID2>"        // 別のフォルダにコピー可能 / Can copy to different folders
        }
    ],
    parentId: "<コピー先フォルダID>"       // コピー先の親フォルダID / Destination parent folder ID
})

フォルダ内の子アイテムを取得 / Get Children Items

// フォルダ内の子アイテムを取得 / Get items in a folder
mcp_bookmark_get_children({
    id: "<フォルダID>"  // 親フォルダのID / Parent folder ID
})

// トップ階層のフォルダ一覧を取得 / Get root folders
mcp_bookmark_get_children({
    id: "0"  // 特別なID "0" を指定してルートフォルダを取得 / Use special ID "0" to get root folders
})

注意事項 / Notes

  • Chrome拡張機能のインストールが必要です。
    Chrome extension installation is required.

  • ブックマークの変更は即座にChromeに反映されます。
    Bookmark changes are immediately reflected in Chrome.

  • 大量のブックマークを一度に操作する場合は、move_multipleコマンドの使用を推奨します。
    When manipulating multiple bookmarks at once, it is recommended to use the move_multiple command.

トラブルシューティング / Troubleshooting

MCPツールが応答しない場合 / If MCP Tool is Not Responding

  • Chrome拡張機能が有効になっていることを確認
    Verify that the Chrome extension is enabled
  • MCPツールの登録パスが正しいことを確認
    Verify that the MCP tool registration path is correct

拡張機能が動作しない場合 / If Extension is Not Working

  • Chrome拡張機能が有効になっていることを確認
    Verify that the Chrome extension is enabled
  • デベロッパーツールでエラーメッセージを確認
    Check error messages in Developer Tools