H9K雨滴MCP
一个强大的模型上下文协议（MCP）服务器，用于与Raindrop.io书签交互。该服务器公开了14个综合工具，用于通过Raindop.io API管理书签、收藏集和标签。
特性
书签管理
- 搜索_书签 -按关键字、标签、收藏搜索和过滤书签
- get_bookmark -获取特定书签的详细信息
- create_bookmark -添加带有元数据的新书签
- update_bookmark -修改现有书签
- 删除书签 -删除书签
收集管理
- list_collections -查看您的所有收藏/文件夹
- 收集 -获取特定收藏的详细信息
- 创建集合 -创建新收藏
- 更新收集 -修改集合属性
- 删除收集 -删除收藏
标签管理
- list_tags -查看所有计数标签
- 重命名标签 -重命名所有书签中的标签
- delete_tag -从所有书签中删除标签
用户信息
- get_user_info -获取您的帐户信息
安装
- 克隆此存储库：
git clone https://github.com/YOUR_USERNAME/H9K-Raindrop-MCP.git
cd H9K-Raindrop-MCP- 安装依赖项：
npm install- 构建项目：
npm run build获取您的API代币
- 首选 Raindrop.io应用程序设置
- 点击“创建新应用”或使用现有应用
- 点击“创建测试令牌”
- 复制令牌以在下面使用
配置
与Claude Desktop一起使用
将此添加到您的Claude Desktop配置文件中：
macOS/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"h9k-raindrop": {
"command": "node",
"args": ["C:\\Users\\YOUR_USERNAME\\H9K-Raindrop-MCP\\build\\index.js"],
"env": {
"RAINDROP_API_TOKEN": "your-api-token-here"
}
}
}
}替换 C:\\Users\\YOUR_USERNAME\\H9K-Raindrop-MCP\\build\\index.js 使用构建的index.js文件的绝对路径，并替换 your-api-token-here 使用您的实际Raindop.io API代币。
与其他MCP客户端一起使用
设置 RAINDROP_API_TOKEN 环境变量并运行：
node build/index.js示例用法
连接到MCP客户端（如Claude Desktop）后，您可以：
搜索书签：
Search for bookmarks about "machine learning"创建书签：
Create a bookmark for https://example.com with title "Example Site" and tags ["reference", "useful"]组织收藏：
Create a new collection called "Research Papers" and make it public管理标签：
Rename the tag "ml" to "machine-learning" across all my bookmarks获取书签详细信息：
Show me details for bookmark ID 12345发展
项目结构
H9K-Raindrop-MCP/
├── src/
│ ├── index.ts # Main MCP server
│ ├── raindrop-client.ts # Raindrop.io API client
│ └── types.ts # TypeScript types
├── build/ # Compiled JavaScript (generated)
├── package.json
└── tsconfig.json脚本
npm run build-将TypeScript编译为JavaScriptnpm run dev-开发观看模式
api参考
书签工具
搜索_书签
使用各种条件搜索和过滤书签。
参数：
search（可选）：搜索查询字符串collectionId（可选）：按集合筛选（0=全部，-1=未排序）tag（可选）：要筛选的标签数组sort（可选）：排序顺序（-创建、创建、标题等）page（可选）：分页页码perpage（可选）：每页结果（最多50个）
create_bookmark
创建新书签。
参数：
link（必填）：书签的URLtitle（可选）：自定义标题excerpt（可选）：描述note（可选）：个人笔记tags（可选）：标签数组collectionId（可选）：要添加的集合important（可选）：标记为收藏夹
update_bookmark
更新现有书签。
参数：
id（必填）：书签ID- 加上您要更改的create_bookmark中的任何字段
收藏工具
创建集合
创建新收藏。
参数：
title（必填）：收藏名称description（可选）：描述public（可选）：公开view（可选）：视图类型（列表、简单、网格、砌体）parent（可选）：嵌套的父集合ID
标记工具
重命名标签
重命名所有书签中的标签。
参数：
oldName（必填）：当前标签名称newName（必填）：新标签名称
故障排除
服务器无法启动
- 验证您的API令牌是否正确
- 检查Node.js版本是否为18或更高
- 确保构建目录存在（运行
npm run build)
API错误
- 检查您的API令牌是否尚未过期
- 验证您没有达到速率限制（120个请求/分钟）
- 确保书签/收藏ID有效
许可证
麻省理工学院