MCP Bookmark

🚀 MCP Bookmark Server

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

🚀 クイックスタート

MCP Bookmark Serverを使用することで、AIアシスタントがブックマークの保存と検索を行えるようになります。以下の手順に沿ってサーバーをインストールし、設定してください。

✨ 主な機能

• ブックマークの保存：タイトルと説明付きで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

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

{
  "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 Extension)

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ホストで設定した後、自然言語を使用できます。

• "Save this bookmark: https://python.org with title 'Python Official'"
• "Search my bookmarks for React tutorials"
• "Find bookmarks about machine learning"
• "Save https://github.com/microsoft/vscode as a development tool bookmark"

必要条件

• Python 3.11以上
• OpenAI APIキー
• uvxパッケージマネージャーがインストールされていること
• GitHubリポジトリにアクセスするためのインターネット接続

環境変数

• OPENAI_API_KEY: AI駆動の分類と検索強化に必要です。

サポート

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

📄 ライセンス

MIT License

Built for the Model Context Protocol ecosystem