内容
# Raindrop MCP 服务器
Raindrop.io 的模型上下文协议（MCP）服务器，用于书签管理。该服务器通过 MCP 协议使 AI 助手能够与您的 Raindrop.io 书签、收藏、标签等进行交互。
## 功能
- **书签（Raindrops）**：创建、读取、更新和删除书签，自动分页
- **收藏集**：管理书签收藏集和嵌套层次结构
- **标签**：查看和管理书签上的标签
- **用户**：访问已认证的用户信息
- **高亮**：创建和管理书签上的高亮
- **筛选器**：访问收藏集的筛选选项
## 前置条件
- Node.js 18 或更高版本
- Raindrop.io 账户
- Raindrop.io **测试** 访问令牌（[在此处获取令牌](https://app.raindrop.io/settings/integrations)）
## 安装
1. 克隆仓库：
```bash
git clone https://github.com/bitterpanda63/raindrop-mcp-server.git
cd raindrop-mcp-server
```
2. 安装依赖项：
```bash
npm install
```
3. 在根目录中创建 `.env` 文件：
```bash
RAINDROP_TOKEN=your_raindrop_api_token_here
```
4. 构建项目：
```bash
npm run build
```
## 使用
### 运行服务器
启动 MCP 服务器：
```bash
npm start
```
### 使用 MCP 检验工具测试
使用 MCP 检验工具测试服务器：
```bash
npx @modelcontextprotocol/inspector node dist/index.js
```
这将打开一个网页界面，您可以在其中测试所有可用的工具。
### 与 Claude Desktop 一起使用
添加到您的 Claude Desktop 配置文件中：
**macOS**：`~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**：`%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"raindrop": {
"command": "node",
"args": ["/absolute/path/to/raindrop-mcp/dist/index.js"],
"env": {
"RAINDROP_TOKEN": "your_raindrop_api_token_here"
}
}
}
}
```
## 可用工具
### 书签（Raindrops）
- `get_raindrops` - 从收藏集获取所有书签（自动分页）
- `get_raindrop` - 通过 ID 获取单个书签
- `create_raindrop` - 创建新书签
- `update_raindrop` - 更新现有书签
- `delete_raindrop` - 删除书签
### 收藏集
- `get_collections` - 获取根收藏集
- `get_child_collections` - 获取子收藏集
- `get_collection` - 通过 ID 获取单个收藏集
- `create_collection` - 创建新收藏集
- `update_collection` - 更新收藏集
- `delete_collection` - 删除收藏集
### 标签
- `get_tags` - 获取所有标签
- `delete_tag` - 删除标签
### 用户
- `get_user` - 获取已认证的用户信息
### 高亮
- `get_highlights` - 获取书签的高亮
- `create_highlight` - 创建高亮
- `delete_highlight` - 删除高亮
### 筛选器
- `get_filters` - 获取收藏集的筛选器
- `get_suggested_filters` - 获取建议的筛选器
## 开发
在开发模式下运行，并自动重建：
```bash
npm run dev
```
## API 文档
有关 Raindrop.io API 的详细信息，请访问[官方文档](https://developer.raindrop.io)。
## 贡献
欢迎贡献！请随时提交拉取请求。
