Raindrop.io

Raindrop.io MCP-Server

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server für die Interaktion mit dem Lesezeichendienst von Raindrop.io . Es ermöglicht Sprachmodellen (LLMs) und anderen KI-Agenten den Zugriff auf und die Verwaltung Ihrer Raindrop.io-Daten über den MCP-Standard.

Merkmale

• CRUD-Operationen : Erstellen, Lesen, Aktualisieren und Löschen von Sammlungen und Lesezeichen.
• Erweiterte Suche : Filtern Sie Lesezeichen nach verschiedenen Kriterien wie Tags, Domäne, Typ, Erstellungsdatum usw.
• Tag-Verwaltung : Tags auflisten, umbenennen, zusammenführen und löschen.
• Zugriff auf Hervorhebungen : Rufen Sie Texthervorhebungen aus Lesezeichen ab.
• Sammlungsverwaltung : Neu anordnen, erweitern/reduzieren, zusammenführen und leere Sammlungen entfernen.
• Datei-Upload : Laden Sie Dateien direkt auf Raindrop.io hoch.
• Erinnerungen : Legen Sie Erinnerungen für bestimmte Lesezeichen fest.
• Importieren/Exportieren : Starten und überprüfen Sie den Status von Lesezeichenimporten und -exporten.
• Papierkorbverwaltung : Leeren Sie den Papierkorb.
• MCP-Konformität : Stellt Raindrop.io-Funktionen als MCP-Ressourcen und -Tools bereit.
• Streaming-Unterstützung : Bietet SSE-Endpunkte (Server-Sent Events) in Echtzeit für das Streamen von Lesezeichenaktualisierungen.
• Erstellt mit TypeScript : Starke Typisierung für bessere Wartbarkeit.
• Verwendet Axios : Zum Senden von Anfragen an die Raindrop.io-API.
• Verwendet Zod : Für eine robuste Schemavalidierung von API-Parametern und -Antworten.
• Verwendet MCP SDK : Nutzt das offizielle @modelcontextprotocol/sdk .

Voraussetzungen

• Node.js (v18 oder höher empfohlen) oder Bun
• Ein Raindrop.io-Konto
• Ein Raindrop.io API-Zugriffstoken (erstellen Sie eines in Ihren Raindrop.io-Einstellungen )

Installation und Verwendung

Verwendung von NPX (empfohlen)

Sie können den Server direkt mit npx ausführen, ohne es zu installieren:

Aus der Quelle

1. Klonen Sie das Repository:
   git clone https://github.com/adeze/raindrop-mcp.git cd raindrop-mcp
2. Installieren Sie Abhängigkeiten:
   bun install
3. Umgebungsvariablen konfigurieren: Erstellen Sie eine .env Datei im Stammverzeichnis, indem Sie das Beispiel kopieren:
   cp .env.example .env
   Bearbeiten Sie die .env Datei und fügen Sie Ihr Raindrop.io API-Zugriffstoken hinzu:
   RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN
4. Erstellen und Ausführen:
   bun run build bun start

Der Server verwendet standardmäßig die Standardeingabe/-ausgabe (stdio) zur Kommunikation, wartet auf Anfragen auf stdin und sendet Antworten an stdout.

Verwendung mit MCP-Clients

Verbinden Sie Ihren MCP-Client (z. B. einen LLM-Agenten) über stdio mit dem laufenden Serverprozess. Der Server stellt die folgenden Ressourcen-URIs bereit:

• collections://all - Alle Sammlungen
• collections://{parentId}/children – Untergeordnete Sammlungen
• tags://all – Alle Tags
• tags://collection/{collectionId} – Tags nach Sammlung gefiltert
• highlights://all - Alle Highlights
• highlights://raindrop/{raindropId} – Highlights für ein bestimmtes Lesezeichen
• highlights://collection/{collectionId} – Highlights nach Sammlung gefiltert
• bookmarks://collection/{collectionId} – Lesezeichen in einer Sammlung
• bookmarks://raindrop/{id} – Spezifisches Lesezeichen nach ID
• user://info - Benutzerinformationen
• user://stats - Benutzerstatistiken

Es bietet außerdem zahlreiche Tools für operative Aufgaben wie Sammlungsverwaltung, Lesezeichen- und Tag-Verwaltung, Hervorhebungs- und Benutzervorgänge. Eine detaillierte Liste aller verfügbaren Tools finden Sie unter CLAUDE.md oder unter src/services/mcp.service.ts mit Definitionen der Ressourcen und Tools.

MCP-Konfiguration

Um den Raindrop MCP-Server mit Ihrem KI-Assistenten oder MCP-kompatiblen Client zu verwenden, können Sie Ihrer .mcp.json Datei die folgende Konfiguration hinzufügen:

Für Claude Code oder andere MCP-kompatible Clients wird dadurch der Raindrop-Server unter dem Namen „Raindrop“ registriert und alle seine Ressourcen und Tools Ihrem KI-Assistenten zur Verfügung gestellt.

Entwicklung

• Testen: bun test
• Typprüfung: bun run type-check
• Build: bun run build
• Entwicklung: bun run dev
• Debuggen: bun run debug oder bun run inspector
• HTTP-Server: bun run start:http

Beitragen

Beiträge sind willkommen! Bitte melden Sie ein Problem oder senden Sie einen Pull Request.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .