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 文檔