H9K Raindrop MCP

H9K雨滴MCP

一个强大的模型上下文协议（MCP）服务器，用于与Raindrop.io书签交互。该服务器公开了14个综合工具，用于通过Raindop.io API管理书签、收藏集和标签。

特性

书签管理

• 搜索_书签 -按关键字、标签、收藏搜索和过滤书签
• get_bookmark -获取特定书签的详细信息
• create_bookmark -添加带有元数据的新书签
• update_bookmark -修改现有书签
• 删除书签 -删除书签

收集管理

• list_collections -查看您的所有收藏/文件夹
• 收集 -获取特定收藏的详细信息
• 创建集合 -创建新收藏
• 更新收集 -修改集合属性
• 删除收集 -删除收藏

标签管理

• list_tags -查看所有计数标签
• 重命名标签 -重命名所有书签中的标签
• delete_tag -从所有书签中删除标签

用户信息

• get_user_info -获取您的帐户信息

安装

1. 克隆此存储库：

git clone https://github.com/YOUR_USERNAME/H9K-Raindrop-MCP.git
cd H9K-Raindrop-MCP

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

获取您的API代币

1. 首选 Raindrop.io应用程序设置
2. 点击“创建新应用”或使用现有应用
3. 点击“创建测试令牌”
4. 复制令牌以在下面使用

配置

与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编译为JavaScript
• npm run dev -开发观看模式

api参考

书签工具

搜索_书签

使用各种条件搜索和过滤书签。

参数：

• search （可选）：搜索查询字符串
• collectionId （可选）：按集合筛选（0=全部，-1=未排序）
• tag （可选）：要筛选的标签数组
• sort （可选）：排序顺序（-创建、创建、标题等）
• page （可选）：分页页码
• perpage （可选）：每页结果（最多50个）

create_bookmark

创建新书签。

参数：

• link （必填）：书签的URL
• title （可选）：自定义标题
• 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有效

许可证

麻省理工学院

链接

• Raindop.io API文档
• 模型上下文协议
• MCP SDK文档