Gmail MCP Server by CData

Gmail-MCP-Server von CData

CDatas Model Context Protocol (MCP)-Server für Gmail

:heavy_exclamation_mark: Dieses Projekt erstellt einen schreibgeschützten MCP-Server. Für umfassende Lese-, Schreib-, Aktualisierungs-, Lösch- und Aktionsfunktionen sowie eine vereinfachte Einrichtung testen Sie unseren kostenlosen CData MCP-Server für Gmail (Beta) .

Zweck

Wir haben diesen schreibgeschützten MCP-Server erstellt, um LLMs (wie Claude Desktop) die Abfrage von Live-Gmail-Daten zu ermöglichen, die vom CData JDBC-Treiber für Gmail unterstützt werden.

Der CData JDBC-Treiber stellt eine Verbindung zu Gmail her, indem er sie als relationale SQL-Modelle verfügbar macht.

Dieser Server umschließt diesen Treiber und stellt Gmail-Daten über eine einfache MCP-Schnittstelle zur Verfügung, sodass LLMs Live-Informationen abrufen können, indem sie Fragen in natürlicher Sprache stellen – kein SQL erforderlich.

Installationshandbuch

1. Klonen Sie das Repository:
   git clone https://github.com/cdatasoftware/gmail-mcp-server-by-cdata.git cd gmail-mcp-server-by-cdata
2. Erstellen Sie den Server:
   mvn clean install
   Dadurch wird die JAR-Datei erstellt: CDataMCP-jar-with-dependencies.jar
3. Laden Sie den CData JDBC-Treiber für {source} herunter und installieren Sie ihn: https://www.cdata.com/drivers/gmail/download/jdbc
4. Lizenzieren Sie den CData JDBC-Treiber:
   • Navigieren Sie zum Ordner lib im Installationsverzeichnis. Normalerweise:
     • (Windows) C:\Program Files\CData\CData JDBC Driver for Gmail\
     • (Mac/Linux) /Applications/CData JDBC Driver for Gmail/
   • Führen Sie den Befehl java -jar cdata.jdbc.gmail.jar --license
   • Geben Sie Ihren Namen, Ihre E-Mail-Adresse und „TRIAL“ (oder Ihren Lizenzschlüssel) ein.
5. Konfigurieren Sie Ihre Verbindung zur Datenquelle (Salesforce als Beispiel):
   • Führen Sie den Befehl java -jar cdata.jdbc.gmail.jar aus, um das Dienstprogramm „Connection String“ zu öffnen.
   • Konfigurieren Sie die Verbindungszeichenfolge und klicken Sie auf „Verbindung testen“.

     Hinweis: Wenn die Datenquelle OAuth verwendet, müssen Sie sich in Ihrem Browser authentifizieren.

   • Kopieren Sie nach erfolgreichem Abschluss die Verbindungszeichenfolge zur späteren Verwendung.
6. Erstellen Sie eine .prp Datei für Ihre JDBC-Verbindung (z. B. gmail.prp ) mit den folgenden Eigenschaften und im folgenden Format:
   • Präfix – ein Präfix, das für die angezeigten Tools verwendet werden soll
   • ServerName – ein Name für Ihren Server
   • ServerVersion – eine Version für Ihren Server
   • DriverPath – der vollständige Pfad zur JAR-Datei für Ihren JDBC-Treiber
   • DriverClass – der Name der JDBC-Treiberklasse (z. B. cdata.jdbc.gmail.GmailDriver)
   • JdbcUrl – die JDBC-Verbindungszeichenfolge, die mit dem CData JDBC-Treiber verwendet werden soll, um eine Verbindung zu Ihren Daten herzustellen (von oben kopiert)
   • Tabellen - lassen Sie das Feld leer, um auf alle Daten zuzugreifen. Andernfalls können Sie die Tabellen, für die Sie Zugriff erstellen möchten, explizit angeben.
     Prefix=gmail ServerName=CDataGmail ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc.gmail.jar DriverClass=cdata.jdbc.gmail.GmailDriver JdbcUrl=jdbc:gmail:InitiateOAuth=GETANDREFRESH; Tables=

Verwenden des Servers mit Claude Desktop

1. Erstellen Sie die Konfigurationsdatei für Claude Desktop (claude_desktop_config.json), um den neuen MCP-Server im unten stehenden Format hinzuzufügen. Falls die Datei bereits vorhanden ist, fügen Sie den Eintrag zu den mcpServers in der Konfigurationsdatei hinzu.Windows
   { "mcpServers": { "{classname_dash}": { "command": "PATH\\TO\\java.exe", "args": [ "-jar", "PATH\\TO\\CDataMCP-jar-with-dependencies.jar", "PATH\\TO\\gmail.prp" ] }, ... } }
   Linux/Mac
   { "mcpServers": { "{classname_dash}": { "command": "/PATH/TO/java", "args": [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/gmail.prp" ] }, ... } }
   Kopieren Sie bei Bedarf die Konfigurationsdatei in das entsprechende Verzeichnis (z. B. Claude Desktop). Windows
   cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json
   Linux/Mac
   cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'
2. Führen Sie Ihren Client (Claude Desktop) aus oder aktualisieren Sie ihn.

Hinweis: Möglicherweise müssen Sie Ihren Claude Desktop-Client vollständig beenden und erneut öffnen, damit die MCP-Server angezeigt werden.

Ausführen des Servers

1. Führen Sie den folgenden Befehl aus, um den MCP-Server alleine auszuführen
   java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

Hinweis: Der Server verwendet stdio und kann daher nur mit Clients verwendet werden, die auf demselben Computer wie der Server ausgeführt werden.

Nutzungsdetails

Sobald der MCP-Server konfiguriert ist, kann der KI-Client die integrierten Tools zum Lesen, Schreiben, Aktualisieren und Löschen der zugrunde liegenden Daten nutzen. Im Allgemeinen müssen Sie die Tools nicht explizit aufrufen. Bitten Sie den Client einfach, Fragen zum zugrunde liegenden Datensystem zu beantworten. Beispiel:

• „Welche Korrelation besteht zwischen meinen abgeschlossenen und gewonnenen Gelegenheiten und der Kontobranche?“
• „Wie viele offene Tickets habe ich im SUPPORT-Projekt?“
• „Können Sie mir sagen, welche Kalenderereignisse ich heute habe?“

Nachfolgend finden Sie die Liste der verfügbaren Tools und deren Beschreibungen:

Tools & Beschreibungen

In den folgenden Definitionen bezieht sich {servername} auf den Namen des MCP-Servers in der Konfigurationsdatei (z. B. {classname_dash} oben).

• {servername}_get_tables – Ruft eine Liste der in der Datenquelle verfügbaren Tabellen ab. Verwenden Sie das Tool {servername}_get_columns um die verfügbaren Spalten einer Tabelle aufzulisten. Die Ausgabe des Tools wird im CSV-Format zurückgegeben, wobei die erste Zeile die Spaltenüberschriften enthält.
• {servername}_get_columns – Ruft eine Liste der Spalten einer Tabelle ab. Verwenden Sie das Tool {servername}_get_tables um eine Liste der verfügbaren Tabellen abzurufen. Die Ausgabe des Tools wird im CSV-Format zurückgegeben, wobei die erste Zeile die Spaltenüberschriften enthält.
• {servername}_run_query – Führen Sie eine SQL SELECT-Abfrage aus

Fehlerbehebung

1. Wenn Sie Ihren CData MCP-Server in Claude Desktop nicht sehen können, stellen Sie sicher, dass Sie Claude Desktop vollständig beendet haben (Windows: verwenden Sie den Task-Manager, Mac: verwenden Sie den Aktivitätsmonitor).
2. Wenn Claude Desktop keine Daten abrufen kann, überprüfen Sie, ob Ihre Verbindung korrekt konfiguriert ist. Erstellen Sie die Verbindungszeichenfolge mit dem Verbindungszeichenfolgen-Generator (siehe oben) und kopieren Sie sie in die Eigenschaftendatei (.prp).
3. Wenn Sie Probleme beim Herstellen einer Verbindung zu Ihrer Datenquelle haben, wenden Sie sich an das CData-Supportteam .
4. Wenn Sie Probleme bei der Verwendung des MCP-Servers haben oder sonstiges Feedback haben, treten Sie der CData-Community bei.

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE- Datei im Projekt-Repository.

Alle unterstützten Quellen