🚀 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 文件以获取详细信息。