mcp-bookmark

@pree-dew/mcp-bookmark

0 Stars 1 次浏览 pree-dew 更新于 2026-08-23

MCP Server for adding bookmarks in openai RAG

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mcp-bookmark-server": {
      "args": [
        "mcp-bookmark-server@0.1.2"
      ],
      "command": "uvx"
    }
  }
}

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

MCP Bookmark Server

<!- - mcp-name: io.github.pree-dew/mcp-bookmark - ->

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/pree-dew/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/pree-dew/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/pree-dew/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/pree-dew/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/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

查看源码项目主页