书签管理服务器

Raindrop MCP Server是一个功能齐全的书签管理服务器,支持书签、收藏夹、标签和高亮的管理操作。

  • by FyziGo
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 FyziGo/Raindrop-MCP

使用说明

🌧️ 雨滴MCP服务器

⚠️ β版

这是一个测试版!功能可能不完整,API可能会更改,并且会出现错误。 使用风险自负。欢迎反馈和贡献!


一个功能齐全的MCP(模型上下文协议)服务器,用于 Raindrop.io 书签管理。

特性

20工具:

  • 书签:创建、获取、更新、删除、搜索
  • 集合:创建、获取、更新、删除、合并、列表
  • 标签:列表、重命名、删除、合并、建议
  • 亮点:获取、创建、删除
  • 过滤器:获取用于收集的筛选器
  • 用户:获取用户信息

4资源:

  • raindrop://collections -所有收藏
  • raindrop://tags -所有标签
  • raindrop://user -用户信息
  • raindrop://collection/{id}/bookmarks -收藏中的书签

安装

选项1:从版本下载

下载自 GitHub发布:

文件 描述
raindrop-mcp.exe Windows二进制文件
raindrop-mcp-docker.zip Docker镜像
raindrop-mcp.mcpb MCPB安装程序

选项2:MCPB安装程序

# Install using mcpb CLI
mcpb install raindrop-mcp.mcpb

或者双击 raindrop-mcp.mcpb 如果您安装了MCPB Desktop。

选项3:Docker

# From release (download and extract docker.zip first)
docker load -i raindrop-mcp-docker.tar
docker run -i --rm -e RAINDROP_TOKEN=your_token raindrop-mcp

选项4:从源代码构建

git clone https://github.com/FyziGo/Raindrop-MCP.git
cd raindrop-mcp
go build -o raindrop-mcp.exe .

认证

  1. 首选https://app.raindrop.io/settings/integrations
  2. 滚动到“测试令牌”部分
  3. 创建并复制您的令牌

Claude桌面配置

增添 %APPDATA%\Claude\claude_desktop_config.json (Windows)或 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "raindrop": {
      "command": "/path/to/raindrop-mcp.exe",
      "env": {
        "RAINDROP_TOKEN": "your_token_here"
      }
    }
  }
}

使用Docker

{
  "mcpServers": {
    "raindrop": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RAINDROP_TOKEN=your_token_here", "fyzigo/raindrop-mcp"]
    }
  }
}
Advanced: OAuth2 Authentication

对于喜欢OAuth2的用户(需要创建自己的Raindrop应用程序):

  1. 在以下位置创建应用程序https://app.raindrop.io/settings/integrations
  2. 获取您的客户ID和客户密码
  3. 配置:
{
  "mcpServers": {
    "raindrop": {
      "command": "/path/to/raindrop-mcp.exe",
      "env": {
        "RAINDROP_CLIENT_ID": "your_client_id",
        "RAINDROP_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

首次运行时,浏览器会打开进行授权。令牌已保存到 ~/.raindrop-mcp/token.json.

所有工具

类别 工具 描述
书签 create-bookmark 使用URL、标题和标签创建书签
get-bookmark 按ID获取书签
update-bookmark 更新标题、注释、标签、收藏
delete-bookmark 删除书签
search-bookmarks 使用查询、筛选器进行搜索
集合 list-collections 列出所有收藏
create-collection 创建新收藏
get-collection 按ID获取收藏
update-collection 更新收藏
delete-collection 删除收藏
merge-collections 将多个合并为一个
标签 list-tags 列出所有标签
rename-tag 重命名标签
delete-tags 删除标签
merge-tags 将标签合并为一个
suggest-tags 获取URL的标签建议
亮点 get-highlights 从书签中获取亮点
create-highlight 创建亮点
delete-highlight 删除突出显示
其他 get-filters 获取集合筛选器
get-user 获取用户信息

示例提示

  • “列出我的雨滴收藏”
  • “搜索python教程的书签”
  • “创建收藏“阅读列表””
  • 将标签“dev”重命名为“development”
  • “从书签12345获取亮点”

项目结构

raindrop-mcp/
├── main.go
├── api/
│   ├── raindrop.go
│   ├── collections.go
│   └── extended.go
├── tools/
│   ├── tools.go
│   └── extended.go
├── resources/
│   └── resources.go
└── types/
    ├── types.go
    └── extended.go

许可证

麻省理工学院