书签管理MCP服务

Raindrop.io MCP服务器

一个模型上下文协议（MCP）服务器，为AI代理提供对Raindrop.io书签、集合和标签的完全读/写访问权限。

特性

此MCP服务器向AI助手展示了全面的Raindrop.io功能：

📑 雨滴（书签）

• get_raindrop -按ID获取单个书签
• create_raindrop -使用URL、标题、标签和收藏创建新书签
• update_raindrop -更新现有书签
• delete_raindrop -删除书签（移至回收站）
• get_raindrops -使用搜索和分页功能列出收藏中的书签
• search_raindrops -在所有书签中搜索

📁 集合

• 集合 -获取所有根集合
• get_collections_tested -获取嵌套/子集合
• 收集 -按ID获取单个集合
• 创建集合 -使用自定义视图样式创建新集合
• 更新收集 -更新集合属性
• 删除收集 -删除收藏

🏷️ 标签

• 获取标签 -获取特定集合中的所有标签
• 重命名标签 -重命名或合并标签
• delete_tag -从书签中删除标签

👤 用户

• get_user -获取当前用户信息

安装与使用

先决条件

1. 获取Raindop.io API代币：
   • 首选https://app.raindrop.io/settings/integrations
   • 创建新的应用程序/集成
   • 复制“测试令牌”（供个人使用）或设置OAuth

选项1：与Smithery一起使用（托管）

使用此MCP服务器的最简单方法是 史密瑟里:

1. 访问Smithery注册表并找到此服务器
2. 单击“安装”并提供您的Raindop.io API令牌
3. 服务器将自动配置和托管
4. 与Claude Desktop、Cursor或任何兼容MCP的客户端一起使用

选项2：本地安装

从npm安装（发布后）

npm install -g raindrop-mcp-server

或从源代码构建

# Clone the repository
git clone <repository-url>
cd raindrop-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

配置

使用克劳德桌面

添加到您的 claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "raindrop": {
      "command": "node",
      "args": ["/path/to/raindrop-mcp-server/build/index.js"],
      "env": {
        "RAINDROP_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

与其他MCP客户端

使用带有环境变量的标准MCP STDIO传输：

RAINDROP_API_TOKEN="your-token" node build/index.js

使用示例

配置后，您可以向AI助手询问以下问题：

• “显示我所有标记为“设计”的书签”
• “为创建新书签https://example.com带有标签“resources”
• “列出我的所有收藏”
• “创建一个名为‘AI工具’的新集合”
• “将书签ID 12345移动到我的“工作”收藏中”
• “搜索所有关于TypeScript的书签”
• “在所有集合中将标签'js'重命名为'javascript'”

发展

构建

npm run build

观看模式（用于开发）

npm run watch

使用MCP检查员进行测试

npm run inspector

这将打开一个交互式测试界面，您可以在其中调用工具并查看响应。

api参考

系统集合

Raindrop.io具有特殊的系统集合ID：

• 0 -所有书签
• -1 -无分类收藏
• -99 -垃圾桶

速率限制

Raindop.io API允许：

• 每分钟120个请求 每个经过身份验证的用户
• 响应中包含速率限制标头

响应格式

所有工具都从Raindop.io API返回JSON响应。成功的突变包括用更新的数据进行成功确认。

安全

• 永远不要将API令牌提交到版本控制
• 使用环境变量或安全密钥管理
• 使用Smithery时，代币会得到安全处理，不会长期存储

许可证

麻省理工学院

资源

• Raindop.io API文档
• 模型上下文协议
• 史密瑟里