JinDaGe - Raindrop.io MCP Details

article

README

🚀 Raindrop.io MCP 服务器

该项目提供了一个 Model Context Protocol (MCP) 服务器，用于与 Raindrop.io 书签服务进行交互。借助它，语言模型（LLMs）和其他 AI 代理能够通过 MCP 标准来访问和管理您的 Raindrop.io 数据。

🚀 快速开始

这个 Raindrop.io MCP 服务器允许语言模型和 AI 代理通过 MCP 标准与 Raindrop.io 书签服务交互，能实现对书签和集合的丰富管理操作。

✨ 主要特性

** CRUD 操作**：可对集合和书签进行创建、读取、更新和删除操作。
高级搜索：能按标签、域、类型、创建日期等条件过滤书签。
标签管理：支持列出、重命名、合并和删除标签。
高亮访问：可检索书签中的文本高亮内容。
集合管理：能重新排序、展开/折叠、合并和删除空集合。
文件上传：可直接将文件上传到 Raindrop.io。
提醒设置：能为特定书签设置提醒。
导入/导出：可发起并检查书签导入和导出的状态。
回收站管理：可清空回收站。
MCP 合规性：通过 MCP 资源和工具公开 Raindrop.io 功能。
流式支持：提供实时 SSE（服务器发送事件）端点，用于流式传输书签更新。
使用 TypeScript：采用强类型，提高代码维护性。
使用 Axios：用于向 Raindrop.io API 发送请求。
使用 Zod：对 API 参数和响应进行强大的模式验证。
使用 MCP SDK：利用官方 @modelcontextprotocol/sdk。

📦 安装指南

先决条件

Node.js（v18 或更高版本）
Bun 环境

安装步骤

克隆仓库：

git clone https://github.com/yourusername/raindrop-mcp-server.git
cd raindrop-mcp-server

安装依赖项：
```
npm install 或 bun add
```
启动开发服务器（可选）：
```
npm run dev 或 bun run dev
```
构建项目：
```
npm run build 或 bun run build
```
运行测试：
```
npm test 或 bun test
```

💻 使用示例

环境变量

| 属性 | 详情 | |------|------| | PORT | 指定服务器运行的端口，默认为 3000。 | | DEBUG | 启用调试模式，值设为 true。 |

资源 URI

| 路径 | 描述 | |-----------------------|----------------------------| | /api/collections | 操作集合（创建、读取、更新、删除） | | /api/items | 操作书签项 | | /api/search | 根据条件搜索书签 | | /api/tags | 管理标签 | | /api/highlights | 获取高亮文本 |

基础用法

创建新集合

POST /api/collections
Content-Type: application/json

{
  "name": "我的新收藏夹",
  "description": "我的第一个 MCP 集合"
}

搜索书签

GET /api/items?search=技术
HTTP/1.1

🤝 贡献

欢迎贡献！请打开问题或提交拉取请求。

📄 许可证

本项目采用 MIT 许可证 - 请查看 LICENSE 文件以获取详细信息。

Raindrop.io