使用说明

项目简介

Raindrop MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 Raindrop.io 书签服务的桥梁，允许大型语言模型 (LLM) 客户端通过标准化的 MCP 协议，安全、便捷地访问和操作 Raindrop.io 中的书签和集合数据。该服务器通过注册工具的方式，向 LLM 客户端提供书签的搜索、创建和集合信息获取等功能，从而扩展 LLM 的上下文理解和知识库能力。

主要功能点

书签搜索 (search_bookmarks): 允许 LLM 客户端根据关键词搜索 Raindrop.io 中存储的书签。
书签创建 (create_bookmarks): 允许 LLM 客户端在 Raindrop.io 中创建新的书签，方便 LLM 记录和管理信息。
集合获取 (get_collections): 允许 LLM 客户端获取 Raindrop.io 中的所有书签集合信息，用于组织和分类书签。
多种传输协议支持: 支持 Stdio, SSE 和 Streamable HTTP 等多种 MCP 传输协议，方便集成到不同的 LLM 客户端环境中。

安装步骤

由于该项目基于 Node.js 和 npm，你需要先确保你的开发环境中已安装 Node.js 和 npm。

安装 raindrop-mcp 包: 打开终端，运行以下命令全局安装 'raindrop-mcp' 包：
```
npm install -g raindrop-mcp
```
或者，如果你不想全局安装，也可以在项目中使用 'npx' 直接运行，无需安装步骤。
获取 Raindrop.io 访问令牌:
- 访问 Raindrop.io 开发者集成页面。
- 创建一个新的应用 (Application)。
- 为该应用创建一个测试令牌 (Test Token)。
- 复制生成的测试令牌，后续配置服务器时需要用到。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令和参数才能连接到 Raindrop MCP Server。以下是不同传输协议的 JSON 配置示例：

1. Stdio 服务器 (默认):

{
  "mcpServers": {
    "raindrop": {
      "command": "npx",
      "args": ["-y", "raindrop-mcp"],
      "env": {
        "RAINDROP_ACCESS_TOKEN": "<your-token>"  // 替换为你在 Raindrop.io 获取的测试令牌
      }
    }
  }
}

配置参数说明:

'"mcpServers"': 定义 MCP 服务器配置的根节点。
'"raindrop"': 为该 Raindrop MCP Server 定义的服务器名称，可以自定义。
'"command": "npx"': 指定启动服务器的命令为 'npx'，用于执行 npm 包。
'"args": ["-y", "raindrop-mcp"]': 'npx' 命令的参数。
- '"-y"': 'npx' 参数，表示自动安装 'raindrop-mcp' 包（如果尚未安装）。
- '"raindrop-mcp"': 要执行的 npm 包名称，即 'raindrop-mcp'。
'"env"': 环境变量配置。
- '"RAINDROP_ACCESS_TOKEN": "<your-token>"': 设置 Raindrop.io 访问令牌的环境变量，请务必替换 '<your-token>' 为你实际的令牌。

2. SSE 服务器:

{
  "mcpServers": {
    "raindrop-sse": {
      "command": "npx",
      "args": ["-y", "raindrop-mcp", "--sse"],
      "env": {
        "RAINDROP_ACCESS_TOKEN": "<your-token>" // 替换为你的 Raindrop.io 访问令牌
      }
    }
  }
}

配置参数说明:

'"args": ["-y", "raindrop-mcp", "--sse"]': 在默认 Stdio 配置的基础上，添加了 '--sse' 参数，指定使用 SSE (Server-Sent Events) 传输协议。

3. Streamable HTTP 服务器:

{
  "mcpServers": {
    "raindrop-http": {
      "command": "npx",
      "args": ["-y", "raindrop-mcp", "--http", "/custom-endpoint"], // 可以自定义 endpoint，默认为 /mcp
      "env": {
        "RAINDROP_ACCESS_TOKEN": "<your-token>" // 替换为你的 Raindrop.io 访问令牌
      }
    }
  }
}

配置参数说明:

'"args": ["-y", "raindrop-mcp", "--http", "/custom-endpoint"]': 在默认 Stdio 配置的基础上，添加了 '--http' 参数，指定使用 Streamable HTTP 传输协议，并设置了自定义的 endpoint 为 '/custom-endpoint'。如果省略 endpoint，则默认为 '/mcp'。

注意: 请根据你的 MCP 客户端类型选择合适的传输协议配置，并将 '<your-token>' 替换为你在 Raindrop.io 获取的实际访问令牌。

基本使用方法

启动 Raindrop MCP Server: 根据你选择的传输协议，MCP 客户端会根据上述配置自动启动 Raindrop MCP Server。例如，对于 Stdio 配置，客户端会执行 'npx -y raindrop-mcp' 命令来启动服务器。
通过 MCP 客户端调用工具: 一旦服务器成功启动并连接到 MCP 客户端，你就可以通过客户端调用以下工具来操作 Raindrop.io 数据：
- 'search_bookmarks': 搜索书签。你需要提供搜索关键词 'search' 以及其他可选参数，例如 'collection_id' (集合 ID), 'page' (页码) 等。
- 'create_bookmarks': 创建书签。你需要提供包含书签链接 'link' 的 'items' 数组，还可以选择性地提供 'title' 和 'excerpt'。
- 'get_collections': 获取所有集合。此工具无需参数。
具体的工具调用方式和参数格式，请参考你的 MCP 客户端的使用文档。服务器返回的结果将会以 YAML 格式的文本内容呈现。

示例 (假设使用支持 MCP 协议的 LLM 应用):

用户在 LLM 应用中输入指令： "搜索关于 'MCP协议' 的书签"

LLM 应用 (MCP 客户端) 可能会调用 'search_bookmarks' 工具，并传递参数 '{"search": "MCP协议"}' 给 Raindrop MCP Server。服务器执行搜索后，会将搜索结果以 MCP 响应的形式返回给 LLM 应用，LLM 应用再将结果呈现给用户。

关键词

使用说明

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息