项目简介

Raindrop.io MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，它将 Raindrop.io 书签服务的功能以标准化的方式提供给大型语言模型 (LLM) 客户端。通过此服务器，LLM 可以安全、可扩展地访问和管理您的 Raindrop.io 数据，实现上下文感知和功能扩展。

主要功能点

书签和收藏夹的CRUD操作：创建、读取、更新和删除书签和收藏夹。
高级搜索：根据标签、域名、类型、创建日期等多种条件过滤书签。
标签管理：列出、重命名、合并和删除标签。
高亮访问：检索书签中的文本高亮。
文件上传：直接上传文件到 Raindrop.io。
提醒设置：为特定书签设置提醒。
导入导出：发起和检查书签导入和导出的状态。
回收站管理：清空回收站。
实时更新：通过 SSE (Server-Sent Events) 提供书签更新的实时流。

安装步骤

安装 Node.js 或 Bun：确保您的系统已安装 Node.js (v18 或更高版本) 或 Bun。
获取 API 访问令牌：访问 Raindrop.io 设置创建 Raindrop.io API 访问令牌。

使用 NPX 运行 (推荐)：

export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN  # 将 YOUR_RAINDROP_ACCESS_TOKEN 替换为您的令牌
npx @adeze/raindrop-mcp

或

从源代码运行：

git clone https://github.com/adeze/raindrop-mcp.git
cd raindrop-mcp
bun install  # 或 npm install
cp .env.example .env
# 编辑 .env 文件，将 YOUR_RAINDROP_ACCESS_TOKEN 替换为您的令牌
bun run build # 或 npm run build
bun start # 或 npm start

服务器配置

要将 Raindrop MCP 服务器与 MCP 客户端（如 Claude Code）配合使用，您需要在客户端的 '.mcp.json' 配置文件中添加以下配置。这会将 Raindrop 服务器注册为名为 "raindrop" 的服务，并使其资源和工具可供客户端使用。

"raindrop": {
  "command": "npx",  // 启动服务器的命令，这里使用 npx 直接运行
  "args": [
    "@adeze/raindrop-mcp" //  npx 命令的参数，指定要运行的 npm 包
  ],
  "env": {
    "RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_API_TOKEN" // 环境变量，用于传递 Raindrop.io API 令牌，请替换为您的令牌
  }
}

配置参数说明:

'command': 指定用于启动 MCP 服务器的命令。这里设置为 'npx'，表示直接运行 npm 包，无需全局安装。
'args': 一个字符串数组，包含传递给 'command' 命令的参数。这里指定要运行的 npm 包名称 '@adeze/raindrop-mcp'。
'env': 一个键值对对象，用于设置 MCP 服务器运行时的环境变量。这里设置 'RAINDROP_ACCESS_TOKEN' 环境变量，用于服务器身份验证 Raindrop.io API。请务必将 'YOUR_RAINDROP_API_TOKEN' 替换为您在 Raindrop.io 网站上生成的 API 访问令牌。

基本使用方法

启动服务器：按照安装步骤启动 Raindrop MCP 服务器。默认情况下，服务器通过标准输入/输出 (stdio) 与客户端通信。
配置 MCP 客户端：在您的 MCP 客户端（如 Claude Code）中，配置 '.mcp.json' 文件，添加上述 "raindrop" 服务器配置。
客户端访问资源和工具：客户端可以通过资源 URI (例如 'collections://all', 'bookmarks://collection/{collectionId}') 访问 Raindrop.io 数据，并调用预定义的工具 (例如 'createBookmark', 'searchBookmarks') 执行操作。

常用资源 URI 示例：

'collections://all' - 所有收藏夹
'bookmarks://collection/{collectionId}' - 指定收藏夹中的书签
'tags://all' - 所有标签
'highlights://all' - 所有高亮
'user://info' - 用户信息

请参考 'CLAUDE.md' 或 'src/services/mcp.service.ts' 文件查看所有可用的资源和工具的详细列表。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息