raindrop-io-mcp-server

🚀 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

手动安装

1. 克隆仓库：

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

2. 安装依赖项：

npm install

3. 设置环境变量： 创建一个 .env 文件并设置你的 Raindrop.io API 令牌：

RAINDROP_TOKEN=your_access_token_here

4. 构建：

npm run build

💻 使用示例

与 Claude Desktop 使用

基础用法

1. 打开 Claude Desktop 配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 添加以下配置：

{
  "mcpServers": {
    "raindrop": {
      "command": "node",
      "args": ["PATH_TO_BUILD/index.js"],
      "env": {
        "RAINDROP_TOKEN": "your_access_token_here"
      }
    }
  }
}

3. 重启 Claude Desktop

💻 使用示例

可用工具

基础用法

create - bookmark

创建一个新的书签。 参数：

• url：要 bookmark 的 URL（必填）
• title：书签标题（可选）
• tags：标签数组（可选）
• collection：集合 ID（可选）

search - bookmarks

搜索书签。 参数：

• query：搜索查询（必填）
• tags：用于过滤的标签数组（可选）

🔧 技术细节

开发

# 为开发构建
npm run build

# 启动服务器
npm start

⚠️ 重要提示

• 始终使用环境变量管理 API 令牌。
• 设置适当的文件权限。
• 限制不必要的文件访问。

📄 许可证

这是一个开源的 MCP 服务器，任何人都可以使用和贡献。该项目在 MIT License 下发布。

🤝 贡献

欢迎贡献！请随意提交问题、功能请求或拉取请求，以帮助改进此项目。

🔗 相关链接

• 模型上下文协议
• Raindrop.io API 文档