mcp-bookmark

MCP Bookmark Server

OpenAI の RAG 機能を使用して、AI アシスタントがブックマークを保存・検索できるようにする Model Context Protocol（MCP）サーバーです。メタデータとともに URL を保存し、ブックマークのコレクションを対象にインテリジェントな検索を実行できます。

特長

• ブックマークの保存：タイトルや説明とともに URL を保存します
• スマート検索：セマンティック検索を使用して、ブックマークのタイトルや説明を検索します
• AI を活用：OpenAI と連携し、インテリジェントなブックマークの管理と分類を行います
• マルチプラットフォーム：複数の MCP 対応プラットフォームに簡単に統合できます

インストール

pip install mcp-bookmark-server

MCP ホストの設定

Claude Desktop

claude_desktop_config.json に追加します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Cursor IDE

.cursor/mcp_config.json の MCP 設定に追加します：

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Windsurf IDE

windsurf_config.json に追加します：

{
  "mcpServers": {
    "bookmark": {
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Zed Editor

MCP サーバーの項目の下にある Zed の設定に追加します：

{
  "mcp": {
    "servers": {
      "bookmark": {
        "command": "/usr/local/bin/uvx",
        "args": [
          "--from",
          "git+https://github.com/pree-dew/mcp-bookmark.git",
          "mcp-bookmark-server"
        ],
        "env": {
          "OPENAI_API_KEY": "your-openai-api-key-here"
        }
      }
    }
  }
}

Continue（VS Code 拡張機能）

continue/config.json に追加します：

{
  "mcpServers": [
    {
      "name": "bookmark",
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/pree-dew/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  ]
}

利用可能なツール

save_bookmark

新しいブックマークを保存します。

パラメーター：

• url（必須）：ブックマークする URL
• title（任意）：ブックマークのタイトル
• description（任意）：説明

例：

{
  "url": "https://example.com",
  "title": "Example Site",
  "description": "A useful example website"
}

search_bookmarks

保存済みのブックマークを検索します。

パラメーター：

• query（必須）：検索語句

例：

{
  "query": "python tutorial"
}

使用例

MCP ホストで設定すると、自然言語で利用できます：

• 「このブックマークを保存して：https://python.org、タイトルは『Python Official』」
• 「ブックマークから React のチュートリアルを検索して」
• 「機械学習に関するブックマークを探して」
• 「https://github.com/microsoft/vscode を開発ツールのブックマークとして保存して」

要件

• Python 3.11+
• OpenAI API キー
• uvx パッケージマネージャーがインストールされていること
• GitHub リポジトリへのアクセスに必要なインターネット接続

環境変数

• OPENAI_API_KEY：AI による分類と検索の強化に必要です

サポート

• 問題の報告：GitHub Issues
• MCP ドキュメント：Model Context Protocol

ライセンス

MIT License

---

Model Context Protocol エコシステム向けに構築