MCP Bookmark

🚀 MCP书签服务器

MCP书签服务器是一个基于模型上下文协议（MCP）的服务器，它借助OpenAI的检索增强生成（RAG）能力，让AI助手能够保存和搜索书签。你可以存储带有元数据的URL，并对书签集合进行智能搜索。

🚀 快速开始

在使用MCP书签服务器前，请确保满足以下要求：

• Python 3.11及以上版本
• 拥有OpenAI API密钥
• 已安装uvx包管理器
• 能够访问GitHub仓库的网络连接

同时，需要设置环境变量OPENAI_API_KEY，这对于AI驱动的分类和搜索增强功能是必需的。

✨ 主要特性

• 书签保存：存储带有标题和描述的URL。
• 智能搜索：利用语义搜索功能，在书签标题和描述中进行搜索。
• AI驱动：与OpenAI集成，实现智能书签管理和分类。
• 多平台支持：可轻松集成到多个支持MCP的平台。

📦 安装指南

使用以下命令安装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/pree-dew/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/pree-dew/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/pree-dew/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/pree-dew/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/pree-dew/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": "示例网站",
  "description": "一个有用的示例网站"
}

search_bookmarks

用于搜索已保存的书签。 参数说明：

• query（必需）：搜索关键词。

示例：

{
  "query": "Python教程"
}

自然语言使用示例

在与MCP主机完成配置后，你可以使用自然语言进行操作，例如：

• “保存这个书签：https://python.org ，标题为 'Python官方'”
• “搜索我的书签，查找React教程”
• “查找关于机器学习的书签”
• “将https://github.com/microsoft/vscode 保存为开发工具书签”

📚 详细文档

• 问题反馈：GitHub Issues
• MCP文档：模型上下文协议

📄 许可证

本项目采用MIT许可证。

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