mcp-bookmark

MCP Bookmark Server

一个 Model Context Protocol（MCP）服务，可借助 OpenAI 的 RAG 能力，让 AI 助手保存和搜索书签。存储带有元数据的 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 许可证

---

为 Model Context Protocol 生态系统打造