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/preedew17/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/preedew17/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/preedew17/mcp-bookmark.git",
        "mcp-bookmark-server"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Zed Editor

MCP サーバーの設定の下に追加します：

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

Continue（VS Code Extension）

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

{
  "mcpServers": [
    {
      "name": "bookmark",
      "command": "/usr/local/bin/uvx",
      "args": [
        "--from",
        "git+https://github.com/preedew17/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 エコシステム向けに構築