使用说明
🌧️ 雨滴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 .
认证
- 首选https://app.raindrop.io/settings/integrations
- 滚动到“测试令牌”部分
- 创建并复制您的令牌
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应用程序):
- 在以下位置创建应用程序https://app.raindrop.io/settings/integrations
- 获取您的客户ID和客户密码
- 配置:
{
"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
许可证
麻省理工学院
