Raindrop.io

Raindrop.io MCP 服务器

该项目提供了一个模型上下文协议 (MCP) 服务器，用于与Raindrop.io书签服务进行交互。它允许语言模型 (LLM) 和其他 AI 代理通过 MCP 标准访问和管理您的 Raindrop.io 数据。

特征

• CRUD 操作：创建、读取、更新和删除集合和书签。
• 高级搜索：按标签、域、类型、创建日期等各种条件过滤书签。
• 标签管理：列出、重命名、合并和删除标签。
• 突出显示访问：从书签中检索文本突出显示。
• 收藏管理：重新排序、展开/折叠、合并和删除空收藏。
• 文件上传：将文件直接上传到 Raindrop.io。
• 提醒：为特定书签设置提醒。
• 导入/导出：启动并检查书签导入和导出的状态。
• 垃圾管理：清空垃圾。
• MCP 合规性：将 Raindrop.io 功能作为 MCP 资源和工具公开。
• 流支持：为流式书签更新提供实时 SSE（服务器发送事件）端点。
• 使用 TypeScript 构建：强类型，可维护性更好。
• 使用 Axios ：向 Raindrop.io API 发出请求。
• 使用 Zod ：用于 API 参数和响应的强大模式验证。
• 使用 MCP SDK ：利用官方@modelcontextprotocol/sdk 。

先决条件

• Node.js（建议使用 v18 或更高版本）或 Bun
• Raindrop.io 帐户
• Raindrop.io API 访问令牌（在您的Raindrop.io 设置中创建一个）

安装和使用

使用 NPX（推荐）

您可以直接使用 npx 运行服务器，而无需安装它：

来自源

1. 克隆存储库：
   git clone https://github.com/adeze/raindrop-mcp.git cd raindrop-mcp
2. 安装依赖项：
   bun install
3. **配置环境变量：**通过复制示例在根目录中创建.env文件：
   cp .env.example .env
   编辑.env文件并添加您的 Raindrop.io API 访问令牌：
   RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
4. 构建并运行：
   bun run build bun start

服务器默认使用标准输入/输出（stdio）进行通信，监听 stdin 上的请求并将响应发送到 stdout。

与 MCP 客户端一起使用

通过 stdio 将 MCP 客户端（例如 LLM 代理）连接到正在运行的服务器进程。服务器公开以下资源 URI：

• collections://all - 所有收藏
• collections://{parentId}/children - 子集合
• tags://all - 所有标签
• tags://collection/{collectionId} - 按集合过滤的标签
• highlights://all - 所有精彩内容
• highlights://raindrop/{raindropId} - 特定书签的突出显示
• highlights://collection/{collectionId} - 按集合筛选的精彩内容
• bookmarks://collection/{collectionId} - 收藏夹中的书签
• bookmarks://raindrop/{id} - 根据 ID 指定书签
• user://info - 用户信息
• user://stats - 用户统计

它还提供了许多用于操作任务的工具，例如集合管理、书签操作、标签管理、高亮操作和用户操作。有关所有可用工具的详细列表，请参阅CLAUDE.md或查看src/services/mcp.service.ts资源和工具的定义。

MCP 配置

要将 Raindrop MCP 服务器与您的 AI 助手或兼容 MCP 的客户端一起使用，您可以将以下配置添加到您的.mcp.json文件：

对于 Claude Code 或其他与 MCP 兼容的客户端，这将以“raindrop”名称注册 Raindrop 服务器，并将其所有资源和工具提供给您的 AI 助手。

发展

• 测试： bun test
• 类型检查： bun run type-check
• 构建： bun run build
• 开发： bun run dev
• 调试： bun run debug或bun run inspector
• HTTP 服务器： bun run start:http

贡献

欢迎贡献！请打开一个问题或提交一个拉取请求。

执照

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