Raindrop.io MCP 服务器

该项目为与 Raindrop.io 书签服务交互提供了一个 Model Context Protocol (MCP) 服务器。它允许语言模型（LLMs）和其他 AI 代理通过 MCP 标准访问和管理您的 Raindrop.io 数据。

功能

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

使用说明

环境变量

• PORT：指定服务器运行的端口，默认为 3000。
• DEBUG：启用调试模式，值设为 true。

资源 URI

以下是 MCP 服务器提供的资源 URI：

示例请求

创建新集合

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

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

搜索书签

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

贡献

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

许可证

本项目 licensed under the MIT License - 请查看 LICENSE 文件以获取详细信息。