🚀 Raindrop.io MCP 服务器
本项目是一个集成方案，允许大语言模型（LLMs）借助 Model Context Protocol (MCP) 与 Raindrop.io 的书签进行交互，为大语言模型拓展了书签管理与搜索的能力。
🚀 快速开始
本集成允许大语言模型（LLMs）通过 Model Context Protocol (MCP) 与 Raindrop.io 的书签进行交互。你可以按照以下步骤完成安装和配置，开启使用之旅。
✨ 主要特性
- 创建书签：可轻松创建新的书签。
- 搜索书签：支持对书签进行搜索操作。
- 标签过滤：能够通过标签对书签进行过滤。
📦 安装指南
使用 Smithery 安装
通过 Smithery 可自动安装 Raindrop.io 集成，执行以下命令：
npx -y @smithery/cli install @hiromitsusasaki/raindrop-io-mcp-server --client claude
手动安装
- 克隆仓库：
git clone https://github.com/hiromitsusasaki/raindrop-io-mcp-server
cd raindrop-io-mcp-server
- 安装依赖项：
npm install
- 设置环境变量：
创建一个
.env文件并设置你的 Raindrop.io API 令牌：
RAINDROP_TOKEN=your_access_token_here
- 构建：
npm run build
💻 使用示例
与 Claude Desktop 使用
基础用法
-
打开 Claude Desktop 配置文件：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
添加以下配置：
{
"mcpServers": {
"raindrop": {
"command": "node",
"args": ["PATH_TO_BUILD/index.js"],
"env": {
"RAINDROP_TOKEN": "your_access_token_here"
}
}
}
}
- 重启 Claude Desktop
💻 使用示例
可用工具
基础用法
create - bookmark
创建一个新的书签。 参数：
url：要 bookmark 的 URL（必填）title：书签标题（可选）tags：标签数组（可选）collection：集合 ID（可选）
search - bookmarks
搜索书签。 参数：
query：搜索查询（必填）tags：用于过滤的标签数组（可选）
🔧 技术细节
开发
# 为开发构建
npm run build
# 启动服务器
npm start
⚠️ 重要提示
- 始终使用环境变量管理 API 令牌。
- 设置适当的文件权限。
- 限制不必要的文件访问。
📄 许可证
这是一个开源的 MCP 服务器，任何人都可以使用和贡献。该项目在 MIT License 下发布。
🤝 贡献
欢迎贡献！请随意提交问题、功能请求或拉取请求，以帮助改进此项目。