Raindrop.io MCP 服务器使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器，它使得大型语言模型 (LLM)，如 Claude for Desktop，能够与你的 Raindrop.io 书签进行交互。通过此服务器，你可以直接在 LLM 中创建新的 Raindrop.io 书签，或者搜索已有的书签内容。

主要功能点

创建书签: 允许 LLM 指示服务器在你的 Raindrop.io 账户中创建新的书签，可以指定URL、标题和标签。
搜索书签: 允许 LLM 指示服务器搜索你的 Raindrop.io 书签，支持关键词和标签过滤。
列出收藏夹: 允许 LLM 指示服务器列出你的 Raindrop.io 收藏夹列表。

安装步骤

克隆仓库:

git clone https://github.com/hiromitsusasaki/raindrop-io-mcp-server
cd raindrop-io-mcp-server

安装依赖:
```
npm install
```
配置环境变量:
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中设置你的 Raindrop.io API 令牌。你可以在 Raindrop.io 的设置中找到或创建 API 令牌。
```
RAINDROP_TOKEN=你的_Raindrop.io_API令牌
```
构建项目:
```
npm run build
```

服务器配置 (用于 MCP 客户端，如 Claude for Desktop)

要将此 MCP 服务器与 MCP 客户端（如 Claude for Desktop）连接，你需要配置客户端以启动此服务器。以下是 Claude for Desktop 的配置示例，你需要将其添加到 Claude for Desktop 的配置文件 'claude_desktop_config.json' 中。

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

在 'claude_desktop_config.json' 文件的 'mcpServers' 部分添加以下配置：

{
  "mcpServers": {
    "raindrop": {  // "raindrop" 是你为该服务器指定的名称，可以自定义
      "command": "node", // 启动服务器的命令，这里使用 Node.js
      "args": ["PATH_TO_BUILD/index.js"] // 服务器启动脚本的路径，请将 PATH_TO_BUILD 替换为你的项目 build 目录的实际路径，例如 "build/index.js"
    }
  }
}

注意:

'"raindrop"': 服务器名称，可以自定义，用于在 Claude 中引用。
'"command": "node"': 指定使用 Node.js 运行 JavaScript 代码。
'"args": ["PATH_TO_BUILD/index.js"]': 请务必将 'PATH_TO_BUILD' 替换为你在本地克隆的 'raindrop-io-mcp-server' 仓库中 'build' 目录的绝对或相对路径。 例如，如果你的 'build' 目录在用户主目录下，并且你将配置放在 'claude_desktop_config.json' 文件旁边，则可能是 '["./raindrop-io-mcp-server/build/index.js"]' (根据实际情况调整路径)。

配置完成后，重启 Claude for Desktop 使配置生效。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 应用（如配置了的 Claude for Desktop）中，你可以使用自然语言指令来调用 Raindrop.io 的功能。例如：

创建书签: 你可以直接告诉 Claude "请帮我把这个网页保存到 Raindrop.io [网页链接]" 或 "创建一个书签，链接是 [网页链接]，标题是 [书签标题]，标签是 [标签1, 标签2]"。
搜索书签: 你可以询问 Claude "搜索我在 Raindrop.io 中关于 [关键词] 的书签" 或 "查找我在 Raindrop.io 中标签为 [标签名] 的书签"。
列出收藏夹: 你可以询问 Claude "列出我在 Raindrop.io 中的所有收藏夹"。

LLM 会解析你的指令，并调用相应的 MCP 工具与 Raindrop.io MCP 服务器进行交互，从而完成书签的创建和搜索等操作。

关键词