Raindrop MCP 服务器

这是 Raindrop.io 的模型上下文协议 (MCP) 服务器，由Python MCP SDK提供支持。它提供了一种简便的方法，让您能够以简单易懂的语言从 Claude Desktop 读取和更新您的 Raindrop 集合、雨滴和标签。它可以与Firecrawl MCP 服务器等配合使用，从而简化 Raindrop 集合和标签系统的自动化和组织。

要求

• Python 3.12+
• uv包管理器
• 克劳德桌面
• Raindrop.io 帐户和 API 令牌

设置

1. 获取 Raindrop API 令牌

1. 前往Raindrop.io 开发者门户
2. 创建新应用
3. 复制您的 API 令牌

2. 设置您的 API 令牌

将您的 Raindrop API 令牌设置为环境变量：

1. 在根目录中创建一个 .env 文件
2. 添加新行： RAINDROP_TOKEN="your_token_here"

发展

要在开发模式下运行服务器：

安装

要将服务器安装到 Claude Desktop：

这将在本地启动服务器并允许您测试更改。

特征

服务器提供：

• 通过功能访问您的 Raindrop 集合和雨滴数据
• 支持通过 ID 查看根集合、子集合或特定集合
• 创建、更新和删除集合和雨滴的工具
• 创建和更新新标签的工具

工具

该服务器提供以下 MCP 工具，让 Claude Desktop 对您的 Raindrop 集合执行操作：

创建集合

在 Raindrop.io 中创建一个新集合。

参数：

• title （必填）：收藏集名称
• view ：视图类型（列表、网格、砌体、简单）
• public ：该集合是否公开
• parent_id ：父集合的 ID（根集合则省略）

更新集合

更新 Raindrop.io 中现有的集合。

参数：

• collection_id （必需）：要更新的集合的 ID
• title ：该系列的新名称
• view ：视图类型（列表、网格、砌体、简单）
• public ：该集合是否公开
• parent_id ：父集合的 ID（根集合则省略）
• expanded ：集合是否扩展

删除集合

从 Raindrop.io 中删除一个收藏集。雨滴将被移至“废纸篓”。

参数：

• collection_id （必需）：要删除的集合的 ID

清空垃圾桶

清空 Raindrop.io 中的垃圾箱，永久删除其中的所有雨滴。

获取雨滴

根据 ID 从 Raindrop.io 获取一滴雨滴。

参数：

• raindrop_id （必填）：要获取的雨滴的 ID

获取雨滴

从 Raindrop.io 集合中获取多个雨滴。

参数：

• collection_id （必需）：用于获取雨滴的集合 ID。0 表示所有雨滴，-1 表示未分类，-99 表示垃圾。
• search ：可选搜索查询
• sort ：排序顺序（选项：-created、created、score、-sort、title、-title、domain、-domain）
• page ：页码（从0开始）
• perpage ：每页项目数（最多 50 个）
• nested ：是否包含嵌套集合中的雨滴

获取标签

从 Raindrop.io 获取标签。

参数：

• collection_id ：用于获取标签的集合 ID（可选）。未指定时，将检索所有集合中的所有标签。

更新雨滴

更新 Raindrop.io 中现有的雨滴（书签）。

参数：

• raindrop_id （必填）：需要更新的雨滴的ID
• title ：雨滴的新标题
• excerpt ：新的描述/摘录
• link ：新网址
• important ：设置为 True 以标记为收藏
• tags ：要分配的标签列表
• collection_id ：将雨滴移动到的集合的 ID
• cover ：封面图片的 URL
• type ：雨滴的类型
• order ：排序顺序（升序） - 设置为 0 移动到第一位
• pleaseParse ：设置为 True 以在后台重新解析元数据（封面、类型）

更新许多雨滴

一次更新集合中的多个雨滴。

参数：

• collection_id （必填）：包含要更新的雨滴的集合的 ID
• ids ：需要更新的特定雨滴 ID 的可选列表
• important ：设置为 True 则标记为收藏，设置为 False 则取消标记
• tags ：要添加的标签列表（或空列表以删除所有标签）
• cover ：封面图片的 URL（使用 '' 设置所有图片的截图）
• target_collection_id ：要将雨滴移动到的集合的 ID
• nested ：包括嵌套集合中的雨滴
• search ：可选搜索查询，用于过滤要更新的雨滴

示例查询

将服务器安装到 Claude Desktop 后，您可以向 Claude 询问以下问题和命令：

• “向我展示我所有的 Raindrop 收藏”
• “我有任何与编程相关的收藏吗？”
• “将此标签添加到此集合中的所有雨滴”
• “显示我的 Raindrop 系列（ID 为 12345）的详细信息”
• “Raindrop 中有哪些子集合？”
• “创建一个名为‘Claude Resources’的新 Raindrop 系列”

依赖项

请参阅pyproject.toml了解依赖项。

使用uv run mcp install或uv run mcp dev时将自动安装这些。

贡献

欢迎贡献！您可以通过以下方式为本项目做出贡献：

1. 分叉存储库
2. 创建一个新分支（ git checkout -b feature/your-feature-name ）
3. 进行更改
4. 验证它们是否按预期工作
5. 提交您的更改（ git commit -m 'Add some feature' ）
6. 推送到分支（ git push origin feature/your-feature-name ）
7. 打开拉取请求

请确保您的代码遵循现有风格并包含适当的文档。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE.txt文件。