Raindrop MCP Server

雨滴MCP服务器

需求

• Python 3.12+
• 紫外线 包管理器
• 克劳德桌面
• Raindrop.io账户和API代币

设置

1.获取一个雨滴API代币

1. 首选 Raindrop.io开发者门户
2. 创建新应用程序
3. 复制您的API令牌

2.设置您的API代币

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

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

发展

要在开发模式下运行服务器，请执行以下操作：

uv run mcp dev server.py

安装

要将服务器安装到Claude Desktop，请执行以下操作：

uv run mcp install server.py

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

特性

服务器提供：

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

查询示例

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

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

以下是Claude Desktop（与Firecrawl MCP服务器配对）中的一些示例用法：

输入Claude Desktop作为分类系统：

Claude Desktop的输出：

工具

服务器提供以下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中的垃圾桶，永久删除其中的所有雨滴。

get_raindrop

通过ID从raindrop.io获取单个雨滴。

参数：

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

get_raindrops

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

参数：

• collection_id （必填）：从中提取雨滴的集合的ID。对所有雨滴使用0，对未分类的雨滴使用-1，对垃圾使用-99。
• search：可选搜索查询
• sort：排序顺序（选项：创建、创建、评分、排序、标题、标题、域、域）
• page：页码（从0开始）
• perpage：每页最多50个项目
• nested：是否包含嵌套集合中的雨滴

获取标签

从Raindrop.io获取标签。

参数：

• collection_id：从中获取标签的集合的可选ID。如果未指定，将检索所有集合中的所有标签。

update_raindrop

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

参数：

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

update_many_raindrops

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

参数：

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

依赖项

请看 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 文件以获取详细信息。