Raindrop.io MCP 服务器

该项目提供了一个用于与 Raindrop.io 书签服务交互的 Model Context Protocol (MCP) 服务器。它允许语言模型（LLMs）和其他 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 运行服务器，而无需安装：

# Set your API token as an environment variable
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN

# Run the server
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代码或其他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 文件。