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 直接运行服务器，而无需安装它：

# 将您的 API 令牌设置为环境变量
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN

# 运行服务器
npx @adeze/raindrop-mcp

从源码

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 文件中：

"raindrop": {
  "command": "npx",
  "args": [
    "@adeze/raindrop-mcp"
  ],
  "env": {
    "RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_API_TOKEN"
  }
}

对于 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

贡献

欢迎贡献！请打开一个 issue 或提交一个 pull request。

许可证

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