Raindrop MCP 服务器

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

要求

• Python 3.12+
• uv 包管理器
• Claude Desktop
• 一个 Raindrop.io 帐户和 API 令牌

设置

1. 获取 Raindrop 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

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

功能

该服务器提供：

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

工具

该服务器提供以下 MCP 工具，使 Claude Desktop 能够对您的 Raindrop 收藏集执行操作：

create_collection

在 Raindrop.io 中创建一个新的收藏集。

参数：

• title（必需）：收藏集的名称
• view：视图类型（list、grid、masonry、simple）
• public：收藏集是否公开
• parent_id：父收藏集的 ID（根收藏集省略）

update_collection

更新 Raindrop.io 中现有的收藏集。

参数：

• collection_id（必需）：要更新的收藏集的 ID
• title：收藏集的新名称
• view：视图类型（list、grid、masonry、simple）
• public：收藏集是否公开
• parent_id：父收藏集的 ID（根收藏集省略）
• expanded：收藏集是否展开

delete_collection

从 Raindrop.io 中删除一个收藏集。条目将被移动到回收站。

参数：

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

empty_trash

清空 Raindrop.io 中的回收站，永久删除其中的所有条目。

get_raindrop

从 Raindrop.io 中按 ID 获取单个条目。

参数：

• raindrop_id（必需）：要获取的条目的 ID

get_raindrops

从 Raindrop.io 收藏集中获取多个条目。

参数：

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

get_tags

从 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（使用 '<screenshot>' 为所有条目设置屏幕截图）
• target_collection_id：要将条目移动到的收藏集的 ID
• nested：包含来自嵌套收藏集的条目
• search：可选的搜索查询，用于过滤要更新的条目

示例查询

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

• "显示我所有的 Raindrop 收藏集"
• "我是否有任何与编程相关的收藏集？"
• "将此标签添加到此收藏集中的所有条目"
• "显示 ID 为 12345 的 Raindrop 收藏集的详细信息"
• "我在 Raindrop 中有哪些子收藏集？"
• "创建一个名为 'Claude Resources' 的新 Raindrop 收藏集"

依赖项

请参阅 pyproject.toml 以获取依赖项。

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

贡献

欢迎贡献！以下是如何为此项目做出贡献：

1. Fork 存储库
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. 打开一个 pull request

请确保您的代码遵循现有的样式，并包含适当的文档。

许可证

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