项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在让 AI 助手能够无缝访问和管理您的 Raindrop.io 账户。它将 Raindrop.io 的各种 API 功能（如书签、收藏夹、标签、高亮批注等）封装成易于 AI 调用的工具，支持流式 HTTP 或标准 I/O (stdio) 传输协议，为您的智能助手提供丰富的上下文和操作能力。

主要功能点

书签管理： 创建、读取、更新和删除书签，支持全文搜索和高级过滤。
收藏夹管理： 列出、获取、创建、更新和删除收藏夹（文件夹）。
标签管理： 获取所有标签及其使用计数，支持重命名和删除标签。
高亮批注： 对书签中的文本创建、获取、更新和删除高亮或批注。
批量操作： 支持对多个书签进行批量移动、删除、更新、添加或移除标签。
高级过滤和搜索： 利用丰富的过滤条件（如标签、重要性、创建日期、域名）来精细化搜索和组织书签。
导入/导出： 支持从外部源导入书签到 Raindrop.io，或将书签导出为各种格式。
账户信息： 获取当前认证用户的 Raindrop.io 账户详情。

安装步骤

克隆仓库：

git clone https://github.com/lesleslie/raindropio-mcp.git
cd raindropio-mcp

安装依赖： 确保您已安装 Python 3.13+ 和 'uv' (推荐的包管理器)。
```
uv sync
```

服务器配置

在启动服务器之前，您需要获取一个 Raindrop.io 的个人访问令牌，并将其设置为环境变量 'RAINDROP_TOKEN'。

您可以通过导出变量或在项目根目录创建 '.env' 文件来设置：

export RAINDROP_TOKEN="your-raindrop-token"
# 或者在 .env 文件中添加:
# RAINDROP_TOKEN="your-raindrop-token"

MCP 客户端通常需要一个 JSON 格式的配置来连接服务器。以下是一个示例配置，展示了如何连接此 MCP 服务器：

{
  "name": "Raindrop.io MCP Server",
  "command": "uv",
  "args": ["run", "python", "-m", "raindropio_mcp", "--http", "--http-port", "3034"],
  "description": "通过 MCP 协议访问和管理 Raindrop.io 书签、收藏夹和高亮批注。",
  "tags": ["书签管理", "收藏夹", "知识管理", "AI集成"],
  "environment": {
    "RAINDROP_TOKEN": {
      "type": "secret",
      "description": "您的 Raindrop.io 个人访问令牌。请从 Raindrop.io 官网获取并妥善保管。"
    }
  },
  "capabilities": {
    "tools": [
      "list_collections",
      "get_collection",
      "create_collection",
      "update_collection",
      "delete_collection",
      "list_bookmarks",
      "search_bookmarks",
      "get_bookmark",
      "create_bookmark",
      "update_bookmark",
      "delete_bookmark",
      "list_highlights",
      "get_highlight",
      "create_highlight",
      "update_highlight",
      "delete_highlight",
      "batch_move_bookmarks",
      "batch_delete_bookmarks",
      "batch_update_bookmarks",
      "batch_tag_bookmarks",
      "batch_untag_bookmarks",
      "apply_filters",
      "get_filtered_bookmarks_by_collection",
      "import_bookmarks",
      "export_bookmarks",
      "list_tags",
      "rename_tag",
      "delete_tag",
      "get_account_profile",
      "ping"
    ]
  }
}

配置参数注释：

'command': 启动 MCP 服务器的命令，通常是 'uv' 或 'python'。
'args': 传递给 'command' 的参数列表。
- 'run': 'uv' 命令的子命令，用于运行 Python 脚本。
- 'python -m raindropio_mcp': 以模块方式运行 Raindrop.io MCP 服务器。
- '--http': 启用 HTTP 传输模式（默认为 stdio）。
- '--http-port 3034': 指定 HTTP 服务器监听的端口。您可以根据需要修改。
'environment.RAINDROP_TOKEN': 说明如何配置 Raindrop.io 令牌。在 MCP 客户端中，通常会提供一个界面来让用户输入此令牌，客户端会将它安全地注入到服务器的环境变量中。

基本使用方法

启动服务器后，您的 MCP 客户端即可通过上述配置连接到此 Raindrop.io MCP 服务器，并开始利用其提供的工具与 Raindrop.io 进行交互。例如，一个 AI 助手可以调用 'list_collections' 工具来获取您的收藏夹列表，然后调用 'create_bookmark' 工具将一个链接保存到特定的收藏夹中。

启动服务器示例：

标准 I/O (stdio) 模式 (默认)：

uv run python -m raindropio_mcp
# 或通过控制台脚本
uv run raindropio-mcp

HTTP 模式 (推荐用于多数 MCP 客户端)：

uv run python -m raindropio_mcp --http --http-port 3034

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息