Raindrop.io

🚀 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 环境

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

   npm install 或 bun add
   

3. 启动开发服务器（可选）：

   npm run dev 或 bun run dev
   

4. 构建项目：

   npm run build 或 bun run build
   

5. 运行测试：

   npm test 或 bun test
   

💻 使用示例

环境变量

资源 URI

基础用法

创建新集合

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

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

搜索书签

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

🤝 贡献

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

📄 许可证

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