Back to Browse

Bookmark MCP Server

Developer ToolsUse Caution4.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

An MCP server that provides [describe what your server does]

About

An MCP server that provides [describe what your server does]

Security Report

4.2
Use Caution4.2High Risk

The MCP bookmark server uses OpenAI's API for semantic search and storage, with proper authentication via environment variables. However, there are several security and code quality concerns: missing input validation on user-provided bookmark data before uploading to OpenAI, potential information disclosure through verbose logging, temporary file cleanup issues, and lack of error handling around API failures. The server's permissions are appropriate for its purpose (network_http for OpenAI API, env_vars for credentials, file_system for temporary storage), but implementation gaps create moderate risk. Package verification found 1 issue (1 critical, 0 high severity).

5 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your API key for the serviceRequired

Environment variable: YOUR_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-preedew17-mcp-bookmark": {
      "env": {
        "YOUR_API_KEY": "your-your-api-key-here"
      },
      "args": [
        "mcp-bookmark-server"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

MCP Bookmark Server

A Model Context Protocol (MCP) server that enables AI assistants to save and search bookmarks using OpenAI's RAG capabilities. Store URLs with metadata and perform intelligent searches across your bookmark collection.

Features

  • Save Bookmarks: Store URLs with titles and descriptions
  • Smart Search: Search across bookmark titles and descriptions using semantic search
  • AI-Powered: Integration with OpenAI for intelligent bookmark management and categorization
  • Multi-Platform: Easy integration across multiple MCP-compatible platforms

Installation

pip install mcp-bookmark-server

Configuration for MCP Hosts

Claude Desktop

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

Cursor IDE

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

Windsurf IDE

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

Add to your Zed settings under MCP servers:

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

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

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:

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

License

MIT License


Built for the Model Context Protocol ecosystem

Reviews

No reviews yet

Be the first to review this server!