MCP Bookmark

🚀 MCP Bookmark Server

The MCP Bookmark Server is a Model Context Protocol (MCP) server that empowers AI assistants to save and search bookmarks leveraging OpenAI's RAG capabilities. It allows you to store URLs along with metadata and conduct intelligent searches across your bookmark collection.

✨ Features

• Save Bookmarks: Store URLs with titles and descriptions.
• Smart Search: Conduct semantic searches across bookmark titles and descriptions.
• AI-Powered: Integrate with OpenAI for intelligent bookmark management and categorization.
• Multi-Platform: Easily integrate across multiple MCP-compatible platforms.

📦 Installation

pip install mcp-bookmark-server

📚 Configuration for MCP Hosts

Claude Desktop

Add the following to your 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

Add the following to your MCP settings in .cursor/mcp_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"
      }
    }
  }
}

Windsurf IDE

Add the following to your 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

Add the following to your Zed settings under MCP servers:

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

Add the following to your 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"
      }
    }
  ]
}

📄 Available Tools

save_bookmark

Save a new bookmark.

Parameters:

• url (required): The URL to bookmark.
• title (optional): Title for the bookmark.
• description (optional): Description.

Example:

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

search_bookmarks

Search through saved bookmarks.

Parameters:

• query (required): Search terms.

Example:

{
  "query": "python tutorial"
}

💻 Usage Examples

Once configured with your MCP host, you can use natural language:

• "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"

📋 Requirements

• Python 3.11+
• OpenAI API key
• uvx package manager installed
• Internet connection for GitHub repository access

🔧 Environment Variables

• OPENAI_API_KEY: Required for AI-powered categorization and search enhancement.

🛠️ Support

• Issues: GitHub Issues
• MCP Documentation: Model Context Protocol

📄 License

MIT License

Built for the Model Context Protocol ecosystem