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許可證。

為模型上下文協議生態系統構建