Dropbox MCP Server

dbx-mcp-server

Ein Model Context Protocol (MCP)-Server, der die Integration mit Dropbox ermöglicht und MCP-kompatiblen Clients die Interaktion mit Dropbox über eine Reihe leistungsstarker Tools ermöglicht.

Wichtiger Haftungsausschluss: Dieses Projekt steht in keiner Verbindung zu Dropbox und wird auch nicht von Dropbox unterstützt oder gesponsert. Es handelt sich um eine unabhängige Integration, die mit der öffentlichen API von Dropbox funktioniert.

Inhaltsverzeichnis

• Schnellstart
• Installation
• Authentifizierung
• Verfügbare Tools
• Konfiguration
• Anwendungsbeispiele
• Testen
• Entwicklung
• Lizenz

Schnellstart

1. Klonen Sie das Repository
2. Führen Sie npm install , um Abhängigkeiten zu installieren
3. Führen Sie npm run build , um das Projekt zu erstellen
4. Registrieren Sie eine Dropbox-App in der Dropbox App Console :
   • Wählen Sie die API „Bereichsbezogener Zugriff“
   • Wählen Sie den Zugriffstyp, den Ihre App benötigt
   • Benennen Sie Ihre App und klicken Sie auf „App erstellen“.
   • Wählen Sie unter „Berechtigungen“ die erforderlichen Berechtigungen aus:
     • files.metadata.read
     • files.content.read
     • files.content.write
     • sharing.write
     • account_info.read
   • Fügen Sie http://localhost:3000/callback als Umleitungs-URI hinzu
   • Notieren Sie Ihren App-Schlüssel und Ihr App-Geheimnis
5. Führen Sie das Setup-Skript aus:
   npm run setup
6. Konfigurieren Sie Ihren MCP-Client für die Verwendung des Servers

Installation

1. Klonen Sie das Repository
   git clone https://github.com/your-username/dbx-mcp-server.git cd dbx-mcp-server
2. Installieren Sie Abhängigkeiten und erstellen Sie
   npm install npm run build
3. Ausführen des Setup-Skripts
   npm run setup
4. Zu den MCP-Einstellungen hinzufügenFügen Sie Ihrer MCP-Einstellungsdatei Folgendes hinzu:
   { "mcpServers": { "dbx": { "command": "node", "args": ["/path/to/dbx-mcp-server/build/index.js"] } } }

Authentifizierung

Der Server verwendet OAuth 2.0 mit PKCE zur sicheren Authentifizierung mit Dropbox.

Umgebungsvariablen

Erforderlich:

• DROPBOX_APP_KEY : Der Schlüssel Ihrer Dropbox-App
• DROPBOX_APP_SECRET : Das Geheimnis Ihrer Dropbox-App
• DROPBOX_REDIRECT_URI : OAuth-Umleitungs-URI
• TOKEN_ENCRYPTION_KEY : Schlüssel mit mehr als 32 Zeichen für die Token-Verschlüsselung

Optional:

• TOKEN_REFRESH_THRESHOLD_MINUTES : Minuten vor Ablauf, um das Token zu aktualisieren (Standard: 5)
• MAX_TOKEN_REFRESH_RETRIES : Maximale Anzahl von Aktualisierungsversuchen (Standard: 3)
• TOKEN_REFRESH_RETRY_DELAY_MS : Verzögerung zwischen Aktualisierungsversuchen in ms (Standard: 1000)

Verfügbare Tools

Dateioperationen

• list_files : Dateien in einem Verzeichnis auflisten
• upload_file : Eine Datei hochladen
• download_file : Laden Sie eine Datei herunter
• safe_delete_item : Sicheres Löschen mit Papierkorb-Unterstützung
• create_folder : Einen neuen Ordner erstellen
• copy_item : Kopiert eine Datei oder einen Ordner
• move_item : Verschieben oder Umbenennen einer Datei/eines Ordners

Metadaten und Suche

• get_file_metadata : Datei-/Ordnermetadaten abrufen
• search_file_db : Dateien und Ordner durchsuchen
• get_sharing_link : Freigabelinks erstellen
• get_file_content : Dateiinhalt abrufen

Kontoführung

• get_account_info : Kontoinformationen abrufen

Anwendungsbeispiele

Testen

Führen Sie die Testsuite aus:

Tests überprüfen alle Vorgänge, einschließlich Authentifizierung, Dateivorgänge und Fehlerbehandlung.

Teststruktur

Die Testsuite ist in mehrere Module unterteilt:

• Dropbox-Vorgänge : Tests für grundlegende Dateivorgänge (Upload, Download, Liste usw.)
• Kontovorgänge : Tests für den Zugriff auf Kontoinformationen
• Suchen und Löschen : Tests für Suchfunktionalität und sicheres Löschen mit Papierkorbunterstützung
• Ressourcensystem : Tests für die MCP-Ressourcensystemintegration

Umgang mit Testdaten

Die Tests verwenden dynamisch generierte Datei- und Ordnernamen basierend auf Zeitstempeln, um Konflikte zu vermeiden. Die Testdaten werden nach der Testausführung automatisch bereinigt.

Ausführen bestimmter Tests

So führen Sie eine bestimmte Testdatei oder Testgruppe aus:

Fehlerbehebungstests

Wenn Tests aufgrund von Zeit- oder Authentifizierungsproblemen fehlschlagen:

1. Überprüfen Sie, ob die Mock-Implementierungen in tests/setup.ts Ihren Testerwartungen entsprechen
2. Sicherstellen, dass die Testhelfer richtig konfiguriert sind
3. Vermeiden Sie bei Jest-Bereichsfehlern das Verweisen auf importierte Variablen in Mock-Factory-Funktionen

Entwicklung

Gebaut mit:

• Typoskript
• Model Context Protocol SDK
• Dropbox SDK v10.34.0
• Dropbox API v2

Lizenz

MIT-Lizenz

Copyright (c) 2025 MCP Server Contributors

Hiermit wird jeder Person, die eine Kopie dieser Software und der zugehörigen Dokumentationsdateien (die „Software“) erhält, unentgeltlich die Genehmigung erteilt, mit der Software uneingeschränkt zu verfahren, insbesondere das Recht, die Software zu verwenden, zu kopieren, zu ändern, zusammenzufügen, zu veröffentlichen, zu verteilen, unterzulizenzieren und/oder Kopien der Software zu verkaufen und diese Rechte unter den folgenden Bedingungen anderen Personen zu übertragen:

Der obige Copyright-Vermerk und dieser Genehmigungsvermerk müssen in allen Kopien oder wesentlichen Teilen der Software enthalten sein.

DIE SOFTWARE WIRD „WIE VORLIEGEND“ BEREITGESTELLT, OHNE JEGLICHE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GARANTIE, EINSCHLIESSLICH DER GARANTIE DER MARKTGÄNGIGKEIT, DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND DER NICHTVERLETZUNG. IN KEINEM FALL HAFTEN DIE AUTOREN ODER URHEBERRECHTSINHABER FÜR ANSPRÜCHE, SCHÄDEN ODER ANDERE VERBINDLICHKEITEN, OB AUS VERTRAG, UNERLAUBTER HANDLUNG ODER ANDERWEITIG, DIE AUS DER SOFTWARE ODER DER NUTZUNG ODER DEM ANDEREN UMGANG MIT DER SOFTWARE ENTSTEHEN, DAMIT IN VERBINDUNG STEHEN.