MCP 书签服务器

一个模型上下文协议 (MCP) 服务器，使 AI 助手能够使用 OpenAI 的 RAG 功能保存和搜索书签。存储带有元数据的 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 官网'”
“在我的书签中搜索 React 教程”
“查找关于机器学习的书签”
“将 https://github.com/microsoft/vscode 保存为开发工具书签”

要求

Python 3.11+
OpenAI API 密钥
已安装 uvx 包管理器
访问 GitHub 仓库所需的互联网连接

环境变量

OPENAI_API_KEY：AI 驱动的分类和搜索增强功能所必需

支持

问题反馈：GitHub Issues
MCP 文档：Model Context Protocol

许可证

MIT 许可证

为模型上下文协议生态系统构建

mcp-bookmark-server