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:

# Set your API token as an environment variable
export RAINDROP_ACCESS_TOKEN=YOUR_RAINDROP_ACCESS_TOKEN

# Run the server
npx @adeze/raindrop-mcp

Aus der Quelle

Klonen Sie das Repository:
git clone https://github.com/adeze/raindrop-mcp.git cd raindrop-mcp
Installieren Sie Abhängigkeiten:
bun install
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
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:

"raindrop": {
  "command": "npx",
  "args": [
    "@adeze/raindrop-mcp"
  ],
  "env": {
    "RAINDROP_ACCESS_TOKEN": "YOUR_RAINDROP_API_TOKEN"
  }
}

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 .

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

MCP-Server für den Zugriff auf den Lesezeichen-Manager von Raindrop.io.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Notes Server
truaxki
A
security
A
license
A
quality
An MCP server for managing and persisting notes, offering CRUD operations, note summarization, and resource-based access via a note:// URI scheme.
Last updated -
4
6
Python
MIT License
Weather Service MCP Server
Sunwood-ai-labs
-
security
F
license
-
quality
A simple note-taking MCP server that allows storing and summarizing notes with custom URI schemes and provides functionality to add notes and generate summaries with different detail levels.
Last updated -
5
Python
Raindrop MCP Server
ddltn
-
security
A
license
-
quality
An MCP server that allows Claude Desktop to access and manage Raindrop.io bookmarks through natural language commands, supporting operations for collections, raindrops, and tags.
Last updated -
2
Python
MIT License
Backlinks MCP
cnych
-
security
-
license
-
quality
A MCP server for retrieving backlink information for any domain(SEO).
Last updated -
1
Python
MIT License

View all related MCP servers