Raindrop.io

🚀 Raindrop.io MCP 服務器

本項目構建了一個 Model Context Protocol (MCP) 服務器，用於與 Raindrop.io 書籤服務進行交互。藉助該服務器，語言模型（LLMs）和其他 AI 代理能夠通過 MCP 標準，便捷地訪問和管理您的 Raindrop.io 數據。

🚀 快速開始

本項目為開發者提供了與 Raindrop.io 書籤服務交互的便捷途徑。通過 MCP 服務器，語言模型和 AI 代理可以輕鬆訪問和管理 Raindrop.io 數據。以下是使用本項目的基本步驟：

1. 克隆倉庫：

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

2. 安裝依賴項：

   npm install 或 bun add
   

3. 啟動開發服務器（可選）：

   npm run dev 或 bun run dev
   

4. 構建項目：

   npm run build 或 bun run build
   

5. 運行測試：

   npm test 或 bun test
   

✨ 主要特性

• CRUD 操作：支持對集合和書籤進行創建、讀取、更新和刪除操作。
• 高級搜索：可按標籤、域、類型、創建日期等條件過濾書籤，精準定位所需信息。
• 標籤管理：能夠列出、重命名、合併和刪除標籤，方便對書籤進行分類管理。
• 高亮訪問：可檢索書籤中的文本高亮，快速獲取關鍵內容。
• 集合管理：支持重新排序、展開/摺疊、合併和刪除空集合，優化書籤組織架構。
• 文件上傳：允許直接上傳文件到 Raindrop.io，豐富書籤內容。
• 提醒設置：能為特定書籤設置提醒，避免重要信息遺忘。
• 導入/導出：可發起並檢查書籤導入和導出的狀態，方便數據遷移。
• 回收站管理：支持清空回收站，清理無用數據。
• MCP 合規性：通過 MCP 資源和工具公開 Raindrop.io 功能，確保與 MCP 標準兼容。
• 流式支持：提供即時 SSE（服務器發送事件）端點，用於流式傳輸書籤更新，即時獲取數據變化。
• 使用 TypeScript：採用強類型語言，提高代碼的可維護性和穩定性。
• 使用 Axios：利用 Axios 向 Raindrop.io API 發送請求，簡化網絡請求操作。
• 使用 Zod：對 API 參數和響應進行 robust 的模式驗證，確保數據的準確性。
• 使用 MCP SDK：藉助官方 @modelcontextprotocol/sdk，提升開發效率。

📦 安裝指南

先決條件

• Node.js（v18 或更高版本）
• Bun 環境

安裝步驟

1. 克隆倉庫：

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

2. 安裝依賴項：

   npm install 或 bun add
   

3. 啟動開發服務器（可選）：

   npm run dev 或 bun run dev
   

4. 構建項目：

   npm run build 或 bun run build
   

5. 運行測試：

   npm test 或 bun test
   

💻 使用示例

基礎用法

環境變量設置

• PORT：指定服務器運行的端口，默認為 3000。
• DEBUG：啟用調試模式，值設為 true。

資源 URI

高級用法

創建新集合

POST /api/collections
Content-Type: application/json

{
  "name": "我的新收藏夾",
  "description": "我的第一個 MCP 集合"
}

搜索書籤

GET /api/items?search=技術
HTTP/1.1

📚 詳細文檔

貢獻

歡迎各位開發者為項目貢獻力量！如果您有任何想法或建議，請打開問題或提交拉取請求。

許可證

本項目採用 MIT 許可證 - 請查看 LICENSE 文件以獲取詳細信息。