MCP Bookmark Server

AIアシスタントがOpenAIのRAG機能を使用してブックマークを保存・検索できるようにする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

Zed設定の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拡張機能)

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エコシステム向けに構築されました

mcp-bookmark-server