使用说明

项目简介

Raindrop MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,专为 Raindrop.io 用户设计。它允许你通过 Claude Desktop 以自然语言访问和管理你的 Raindrop.io 书签、收藏夹和标签。借助此服务器,你可以轻松地与 Claude 协同工作,实现 Raindrop.io 的自动化和组织。

主要功能点

  • 访问 Raindrop.io 数据: 允许 Claude Desktop 查看你的 Raindrop.io 收藏夹、书签和标签。
  • 管理收藏夹: 支持创建、更新和删除 Raindrop.io 收藏夹,包括根收藏夹和子收藏夹。
  • 管理书签: 支持获取、更新 Raindrop.io 书签的详细信息,以及批量更新书签属性。
  • 管理标签: 支持获取 Raindrop.io 标签。
  • 垃圾箱操作: 支持清空 Raindrop.io 垃圾箱。

安装步骤

  1. 获取 Raindrop API Token:

  2. 设置 API Token:

    • 在项目根目录下创建 '.env' 文件。
    • 在 '.env' 文件中添加一行:'RAINDROP_TOKEN="你的_API_Token"' (将 "你的_API_Token" 替换为你复制的 Token)。
  3. 安装服务器:

    • 确保你已安装 Python 3.12+ 和 'uv' 包管理器 (参考仓库 README 安装)。
    • 运行命令 'uv run mcp install server.py' 来安装并启动服务器。

服务器配置

要将 Raindrop MCP Server 添加到 MCP 客户端(例如 Claude Desktop),你需要配置以下服务器信息。请将以下 JSON 配置添加到你的 MCP 客户端的服务器列表中。

{
  "serverName": "Raindrop MCP Server",
  "command": "uv run mcp install server.py",
  "args": [],
  "description": "Raindrop MCP Server for managing Raindrop.io collections and bookmarks"
}

配置参数说明:

  • 'serverName': 服务器的名称,可以自定义,用于在 MCP 客户端中识别服务器。
  • 'command': 启动 Raindrop MCP Server 的命令。 'uv run mcp install server.py' 命令会安装并以后台模式启动服务器。
  • 'args': 启动命令的参数,此服务器配置中不需要额外的启动参数,因此为空列表 '[]'。
  • 'description': 服务器的描述信息,方便用户了解服务器的功能。

基本使用方法

安装并配置服务器后,你可以在 Claude Desktop 中使用自然语言与你的 Raindrop.io 数据进行交互。以下是一些示例指令:

  • "Show me all my Raindrop collections" (显示我所有的 Raindrop 收藏夹)
  • "Do I have any collections related to programming?" (我是否有任何与编程相关的收藏夹?)
  • "Add this tag to all raindrops in this collection" (给这个收藏夹中的所有书签添加这个标签)
  • "Show me the details of my Raindrop collection with ID 12345" (显示 ID 为 12345 的 Raindrop 收藏夹的详细信息)
  • "Create a new Raindrop collection called 'Claude Resources'" (创建一个名为 'Claude Resources' 的新 Raindrop 收藏夹)

信息

分类

生产力应用