Notion ReadOnly MCP Server

Notion ReadOnly MCP-Server

Dieses Projekt implementiert einen optimierten schreibgeschützten MCP-Server für die Notion-API und konzentriert sich dabei auf Leistung und Effizienz für KI-Assistenten beim Abfragen und Abrufen von Notion-Inhalten.

Wichtige Verbesserungen

• Schreibgeschütztes Design : Konzentriert sich ausschließlich auf Datenabrufvorgänge und gewährleistet so einen sicheren Zugriff auf Notion-Inhalte.
• Minimierter Werkzeugsatz : Die Anzahl der verfügbaren Notion-API-Tools wurde von über 15 auf nur 6 wesentliche Tools für die Dokumentanalyse reduziert.
• Parallele Verarbeitung : Verbesserte Leistung durch Implementierung asynchroner und paralleler API-Anfragen zum Abrufen von Blockinhalten, wodurch die Antwortzeiten erheblich reduziert werden.
• Erweiterter Datenbankzugriff : Unterstützung für Datenbank-, Seiteneigenschafts- und Kommentarabrufvorgänge hinzugefügt.
• Optimiert für KI-Assistenten : Eine deutlich reduzierte Anzahl an Tools behebt das Problem „Zu viele Tools können die Leistung beeinträchtigen“ bei KI-Assistenten wie Cursor, der die Modelle auf etwa 40 Tools begrenzt.

Werkzeugvergleich

Diese schreibgeschützte Implementierung stellt im Vergleich zur standardmäßigen Notion-API-Integration weitaus weniger Tools bereit, wodurch die Leistung und Kompatibilität mit KI-Assistenten verbessert wird:

Der reduzierte Werkzeugsatz hilft dabei, innerhalb der empfohlenen Werkzeuggrenzen zu bleiben, um eine optimale Leistung des KI-Assistenten zu erzielen und gleichzeitig alle wesentlichen Funktionen bereitzustellen.

Installation

1. Integration in Notion einrichten:

Gehen Sie zu https://www.notion.so/profile/integrations und erstellen Sie eine neue interne Integration oder wählen Sie eine vorhandene aus.

Obwohl wir den Umfang der Notion-APIs auf schreibgeschützte Operationen beschränken, besteht ein nicht unerhebliches Risiko für Arbeitsbereichsdaten, wenn diese LLMs ausgesetzt werden. Sicherheitsbewusste Benutzer sollten die Funktionen der Integration weiter konfigurieren.

Sie können beispielsweise ein schreibgeschütztes Integrationstoken erstellen, indem Sie auf der Registerkarte „Konfiguration“ nur den Zugriff „Inhalte lesen“ gewähren:

2. Hinzufügen der MCP-Konfiguration zu Ihrem Client:

Verwenden von npm:

Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json )

Docker verwenden:

Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu:

Vergessen Sie nicht ntn_**** durch Ihr Integrationsgeheimnis zu ersetzen. Sie finden es auf der Registerkarte „Integrationskonfiguration“.

3. Inhalte mit Integration verknüpfen:

Stellen Sie sicher, dass relevante Seiten und Datenbanken mit Ihrer Integration verbunden sind.

Besuchen Sie dazu die Seite, klicken Sie auf die drei Punkte und wählen Sie „Mit Integration verbinden“ aus.

Verfügbare Tools

Dieser optimierte Server stellt nur die wichtigsten schreibgeschützten Notion-API-Tools bereit:

• API-retrieve-a-page : Seiteninformationen abrufen
• API-get-block-children : Seiteninhaltsblöcke abrufen (mit paralleler Verarbeitung)
• API-retrieve-a-block : Details zu einem bestimmten Block abrufen
• API-retrieve-a-database : Datenbankinformationen abrufen
• API-retrieve-a-comment : Kommentare zu einer Seite oder einem Block abrufen
• API-retrieve-a-page-property : Rufen Sie bestimmte Eigenschaftsinformationen von einer Seite ab
• API-get-one-pager : NEU! Rufen Sie rekursiv eine vollständige Notion-Seite mit allen Blöcken, Datenbanken und zugehörigen Inhalten in einem einzigen Aufruf ab.

Durch die Beschränkung auf diese 7 wesentlichen Tools (im Vergleich zu 15+ in der Standardimplementierung) stellen wir sicher:

1. Bessere Leistung bei KI-Assistenten wie Cursor und Claude, die eine Werkzeuganzahlbeschränkung haben
2. Reduzierte kognitive Belastung für KI-Modelle bei der Auswahl geeigneter Tools
3. Schnellere Reaktionszeiten mit weniger zu berücksichtigenden API-Optionen
4. Verbesserte Sicherheit durch minimierte API-Oberfläche

Automatische Inhaltserkundung

Das neue API-get-one-pager -Tool bietet eine leistungsstarke Möglichkeit, Notion-Seiten zu erkunden, ohne dass mehrere API-Aufrufe erforderlich sind:

• Rekursiver Abruf : Durchläuft automatisch die gesamte Seitenstruktur einschließlich verschachtelter Blöcke
• Parallelverarbeitung : Ruft mehrere Blöcke und ihre untergeordneten Elemente gleichzeitig ab, um maximale Leistung zu erzielen
• Intelligentes Caching : Speichert abgerufene Daten, um redundante API-Aufrufe zu minimieren
• Umfassender Inhalt : Enthält Seiten, Blöcke, Datenbanken, Kommentare und detaillierte Immobilieninformationen
• Anpassbare Tiefe : Steuern Sie den Grad der Rekursion, um ein Gleichgewicht zwischen Detail und Leistung zu finden

Verwenden des OnePager-Tools

Diese automatische Erkundungsfunktion ist besonders nützlich für KI-Assistenten, die den gesamten Inhalt einer Notion-Seite verstehen müssen, ohne Dutzende separater API-Aufrufe durchzuführen, was zu viel schnelleren und effizienteren Antworten führt.

Asynchrone Verarbeitung

Der Server implementiert erweiterte Parallelverarbeitungstechniken für die Handhabung großer Notion-Dokumente:

• Mehrere Anfragen werden gebündelt und gleichzeitig verarbeitet
• Die Paginierung wird für untergeordnete Blöcke automatisch durchgeführt.
• Die Ergebnisse werden effizient aggregiert, bevor sie zurückgegeben werden
• Die Konsolenprotokollierung bietet Einblick in den Prozess, ohne das Antwortformat zu beeinträchtigen.

Beispiele

1. Verwenden Sie die folgende Anweisung:

Die KI ruft die Seitendetails effizient durch parallele Verarbeitung des Blockinhalts ab.

2. Verwenden von Datenbankinformationen:

Entwicklung

Bauen:

Ausführen:

Lizenz

MIT

Leistungsvorteile des KI-Assistenten

Moderne KI-Assistenten wie Cursor und Claude unterliegen Einschränkungen hinsichtlich der Anzahl der Tools, die sie effektiv handhaben können:

• Die meisten Modelle berücksichtigen möglicherweise nicht mehr als 40 Werkzeuge insgesamt
• Zu viele Tools können die Gesamtleistung und die Denkfähigkeiten beeinträchtigen
• Komplexe Toolsets erhöhen die Reaktionsverzögerung und erschweren die Entscheidungsfindung

Diese schreibgeschützte Implementierung reduziert die Notion-API-Oberfläche bewusst, um diese Einschränkungen zu beheben und gleichzeitig alle wesentlichen Funktionen zu erhalten. Das Ergebnis ist:

• Schnellere und zuverlässigere Antworten von KI-Assistenten
• Verbesserte Genauigkeit bei der Interaktion mit Notion-Inhalten
• Bessere Gesamtleistung durch fokussiertes API-Design