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 .