Raindrop MCP Server (Rjskinnaindahizzy)

Raindrop.io MCP服务器

用于与Raindop.io API交互的模型上下文协议（MCP）服务器。此服务器使Claude Code和其他MCP客户端能够管理Raindrop.io帐户中的书签、收藏和标签。

特性

雨滴（书签）管理

• 获取单个或多个书签
• 跨收藏搜索书签
• 使用元数据创建新书签
• 更新现有书签
• 删除书签

馆藏管理

• 列出所有集合（根和嵌套）
• 获取特定收藏详细信息
• 创建新收藏
• 更新集合属性
• 删除收藏

标签管理

• 获取所有标签（可选择按集合筛选）
• 重命名标签
• 将多个标签合并为一个
• 删除标签

用户信息

• 获取当前用户配置文件和设置

安装

选项1：使用MCPB轻松安装（推荐）

安装此MCP服务器的最简单方法是使用Claude Desktop的MCP Bundle（MCPB）文件：

1. 下载 这 raindrop-mcp-server.mcpb 此存储库中的文件
2. 双击 文件（或将其拖动到Claude Desktop）
3. 输入您的API令牌 当系统提示时-从获取https://app.raindrop.io/settings/integrations

就是这样！该捆绑包包含所需的一切，并将在Claude Desktop中自动配置。

选项2：手动安装

如果您更喜欢手动安装或使用其他MCP客户端：

cd raindrop-mcp-server
npm install

然后继续进行下面的手动配置。

配置

手动配置（使用MCPB时跳过）

1.获取Raindop.io API代币

1. 访问https://app.raindrop.io/settings/integrations
2. 创建新应用程序或打开现有应用程序
3. 复制 测试令牌 从您的应用程序设置

2.配置MCP设置

将服务器添加到您的Claude Code MCP设置文件中(~/.config/claude-code/mcp.json 或同等）：

{
  "mcpServers": {
    "raindrop": {
      "command": "node",
      "args": ["/home/user/raindrop-mcp-server/src/index.js"],
      "env": {
        "RAINDROP_TOKEN": "your-token-here"
      }
    }
  }
}

替换 your-token-here 使用您实际的Raindrop.io测试令牌。

备选方案： 您还可以将令牌设置为环境变量：

export RAINDROP_TOKEN="your-token-here"

可用工具

书签工具

get_raindrop

按ID获取单个书签。

参数：

• id （string，必填）：雨滴ID

get_raindrops

通过过滤和分页从收藏中获取书签。

参数：

• collectionId （数字，可选）：集合ID（0=全部，-1=未排序，-99=垃圾桶，默认值：0）
• search （字符串，可选）：搜索查询
• page （数字，可选）：页码（0索引，默认值：0）
• perpage （数字，可选）：每页结果（最多50个，默认值：25个）
• sort （字符串，可选）：排序顺序（-创建、创建、分数、标题等）
• nested （布尔值，可选）：包含嵌套集合中的书签

search_raindrops

在所有收藏中搜索书签。

参数：

• query （字符串，必填）：搜索查询文本
• page （数字，可选）：页码
• perpage （数字，可选）：每页结果

create_raindrop

创建新书签。

参数：

• link （字符串，必填）：书签的URL
• title （字符串，可选）：书签标题
• excerpt （字符串，可选）：描述
• note （字符串，可选）：个人笔记
• collection （数字，可选）：集合ID（-1表示未排序）
• tags （array，可选）：标记字符串数组
• important （布尔值，可选）：标记为收藏夹
• pleaseParse （对象，可选）：从URL自动解析元数据

update_raindrop

更新现有书签。

参数：

• id （string，必填）：要更新的雨滴ID
• link, title, excerpt, note, collection, tags, important （可选）：要更新的字段

delete_raindrop

删除书签（移动到垃圾箱，如果已在垃圾箱中，则永久删除）。

参数：

• id （string，必填）：要删除的雨滴ID

收藏工具

get_collections

获取所有根级别的集合。

get_child_collections

获取所有嵌套（子）集合。

get_collection

按ID获取特定集合。

参数：

• id （string，必填）：集合ID

create_collection

创建新收藏。

参数：

• title （字符串，必填）：集合名称
• view （字符串，可选）：显示视图（列表、网格、砌体）
• sort （数字，可选）：排序顺序
• public （布尔值，可选）：公共可访问性
• parentId （数字，可选）：嵌套的父集合ID

update_collection

更新现有集合。

参数：

• id （string，必填）：集合ID
• title, view, sort, public, parentId, expanded （可选）：要更新的字段

delete_collection

按ID删除集合。

参数：

• id （string，必填）：集合ID

标记工具

get_tags

获取所有标签，可选择按集合过滤。

参数：

• collectionId （数字，可选）：按集合过滤标签

rename_tag

在所有或特定集合中重命名标记。

参数：

• oldTag （字符串，必填）：当前标记名称
• newTag （字符串，必填）：新标记名称
• collectionId （数字，可选）：将范围限制为收集

merge_tags

将多个标签合并为一个。

参数：

• oldTags （array，必填）：要合并的标记名数组
• newTag （字符串，必填）：目标标记名称
• collectionId （数字，可选）：将范围限制为收集

delete_tags

删除一个或多个标签。

参数：

• tags （array，必填）：要删除的标记名数组
• collectionId （数字，可选）：将范围限制为收集

用户工具

get_user

获取当前用户信息和个人资料。

使用示例

在Claude Code中配置后，您可以自然地与Raindrop.io书签交互：

"Show me my recent bookmarks"
"Create a bookmark for https://example.com with tags 'programming' and 'tutorial'"
"Search for bookmarks about 'machine learning'"
"Create a new collection called 'Research Papers'"
"Move bookmark ID 12345 to collection ID 67890"
"Get all my tags"
"Rename tag 'js' to 'javascript'"

API费率限制

Raindop.io API允许 每分钟120个请求 每个经过身份验证的用户。响应中将包含速率限制标头：

• X-RateLimit-Limit
• RateLimit-Remaining
• X-RateLimit-Reset

关于MCP捆绑包（MCPB）

该项目包括 MCP捆绑包 (.mcpb 文件）以简化安装。MCPB是一种标准化的格式，用于打包MCP服务器及其所有依赖关系和配置元数据。

使用MCPB的好处：

• 一键安装 在克劳德桌面
• 无需手动配置 路径或依赖关系
• 自足 -包括所有node_modules和代码
• 自动更新 -更容易分发新版本
• 界面友好 -提示所需的配置（如API令牌）

这 .mcpb 文件本质上是一个zip存档，包含：

• 服务器源代码
• 所有npm依赖项
• A. manifest.json 具有元数据和配置模式
• 许可证和文件

了解有关MCP捆绑包的更多信息：https://github.com/anthropics/mcpb

文档

• Raindop.io API文档
• MCP协议文件
• MCP捆绑规格

许可证

麻省理工学院