使用说明
项目简介
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 垃圾箱。
安装步骤
-
获取 Raindrop API Token:
- 访问 Raindrop.io 开发者门户 并创建一个新的应用。
- 复制你的 API Token。
-
设置 API Token:
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中添加一行:'RAINDROP_TOKEN="你的_API_Token"' (将 "你的_API_Token" 替换为你复制的 Token)。
-
安装服务器:
- 确保你已安装 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 收藏夹)
信息
分类
生产力应用