项目介绍
Raindrop.io MCP Server
此项目提供了一个模型上下文协议（MCP）服务器，用于与Raindrop.io书签服务进行交互。它允许语言模型（LLMs）和其他AI代理通过MCP标准访问和管理您的Raindrop.io数据。
功能
- CRUD 操作：创建、读取、更新和删除集合和书签。
- 高级搜索：按标签、域名、类型、创建日期等不同条件过滤书签。
- 标签管理：列出、重命名、合并和删除标签。
- 高亮访问：从书签中检索文本高亮内容。
- 集合管理：重新排序、展开/折叠、合并和移除空集合。
- 文件上传：直接将文件上传到Raindrop.io。
- 提醒：为特定书签设置提醒。
- 导入/导出：启动并检查书签导入和导出的状态。
- 回收站管理：清空回收站。
- MCP 兼容性：将Raindrop.io功能作为MCP资源和工具公开。
- 优化工具：使用现代
resource_link模式增强工具结构，包含9个核心工具，以实现高效的数据访问。 - AI友好界面：清晰的命名约定和全面的参数文档。
- 流支持：提供实时SSE（服务器发送事件）端点，用于流式传输书签更新。
- 使用TypeScript构建：强类型化以提高可维护性。
- 使用Axios：用于向Raindrop.io API发出请求。
- 使用Zod：对API参数和响应进行健壮的模式验证。
- 使用MCP SDK：利用官方的
@modelcontextprotocol/sdk。
预备条件
- Node.js（推荐版本18或更高）或Bun
- 一个Raindrop.io账户
- 一个Raindrop.io API访问令牌（在您的Raindrop.io设置中创建）
安装和使用
使用NPX（推荐）
您可以直接使用npx运行服务器而不必安装：
# 将您的API令牌设置为环境变量
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
# 运行服务器
npx @adeze/raindrop-mcp
从源代码
-
克隆仓库：
git clone https://github.com/adeze/raindrop-mcp.git cd raindrop-mcp -
安装依赖项：
bun install -
配置环境变量： 在根目录下复制示例创建
.env文件：cp .env.example .env编辑
.env文件，并添加您的Raindrop.io API访问令牌：RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN -
构建和运行：
bun run build bun start
Inspector CLI & VS Code集成
该项目设计用于使用MCP Inspector CLI无缝调试和协议检查。有关详细说明和最佳实践，请参阅./github/prompts/inspector.prompt.md。
MCP Inspector CLI使用
- 列出可用工具：
npx -y @modelcontextprotocol/inspector --cli node build/index.js --method tools/list - 发送协议请求（例如ping）：
npx -y @modelcontextprotocol/inspector --cli node build/index.js --method ping - 使用Inspector调试：
- 对于STDIO服务器：
npx -y @modelcontextprotocol/inspector node build/index.js - 对于HTTP服务器：
npx -y @modelcontextprotocol/inspector node build/server.js
- 对于STDIO服务器：
您可以在VS Code中使用启动配置和任务自动化这些流程。请参阅提示文件以获取更高级场景和标志。
该服务器默认使用标准输入/输出(STDIO)进行通信，在标准输入上监听请求，并将响应发送到标准输出。
使用MCP客户端
将您的MCP客户端（如LLM代理）通过STDIO连接到正在运行的服务器进程。服务器公开以下资源模式：
静态资源：
mcp://user/profile- 用户账户信息diagnostics://server- 服务器诊断和环境信息
动态资源：
mcp://collection/{id}- 通过ID访问任何Raindrop集合（例如，mcp://collection/123456）mcp://raindrop/{id}- 通过ID访问任何Raindrop书签（例如，`m[...]