Nexus MCP

Merkmale

• Google Kalender-Integration

  • Kalenderereignisse erstellen, lesen, aktualisieren und löschen

  • Liste der bevorstehenden Ereignisse

• Obsidian Vault-Verwaltung

  • Notizen erstellen, lesen, aktualisieren und löschen

  • Volltextsuche in Notizen

  • Ordnerverwaltung (Erstellen, Löschen, Suchen, Auflisten)

• Trello-Integration

  • Board-, Listen- und Kartenverwaltung

  • Karten erstellen, aktualisieren und löschen

  • Karten per Textabfrage suchen

• Webseiten-Parsing

  • Extrahieren und bereinigen Sie HTML-Inhalte aus jeder URL

• Google News Suche

  • Suchen Sie nach aktuellen Nachrichtenartikeln zu einem bestimmten Thema

Begleiten Sie mich im Telegramm und Blog

Related MCP server: Daily Briefing MCP Server

Voraussetzungen

• Python 3.10 oder höher

• Poesie (Python-Paketmanager)

• Anmeldeinformationen für die Google Kalender-API

• Trello-API-Anmeldeinformationen (bei Verwendung von Trello-Funktionen)

• Obsidian Vault (bei Verwendung von Obsidian-Funktionen)

Installation

1. Klonen Sie das Repository:

   git clone https://github.com/yourusername/nexus-mcp.git
   cd nexus-mcp

2. Installieren Sie Abhängigkeiten mit Poetry:

   poetry install

3. Google Kalender-API einrichten:

   • Gehen Sie zur Google Cloud Console

   • Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus

   • Aktivieren Sie die Google Kalender-API

   • OAuth 2.0-Anmeldeinformationen erstellen

   • Laden Sie die Anmeldeinformationen herunter und speichern Sie sie als credentials.json im Projektstammverzeichnis

4. Trello-API einrichten (optional):

   • Zum Trello-Entwicklerportal

   • Holen Sie sich Ihren API-Schlüssel und Ihr Token

   • Fügen Sie sie zu Ihren Umgebungsvariablen oder Ihrer Konfigurationsdatei hinzu

Konfiguration

1. Führen Sie die Ersteinrichtung aus, um sich bei Google Kalender zu authentifizieren:

   poetry run python main.py

   • Dadurch wird ein Browserfenster zur Google-Authentifizierung geöffnet

   • Folgen Sie den Anweisungen, um die Anwendung zu autorisieren

Verwendung

1. Starten Sie den Server:

   poetry run python main.py

2. Der Server wird gestartet und ist bereit, MCP-kompatible Clientverbindungen anzunehmen.

3. Verwenden Sie einen beliebigen MCP-kompatiblen Client für die Interaktion mit dem Server. Der Server bietet die folgenden Tools:

   • Kalenderverwaltung

   • Obsidian-Tresorbetrieb

   • Trello-Board-Verwaltung

   • Webseiten-Parsing

Anthropic Claude Desktop-Konfiguration

Um diesen Server mit Anthropic Claude Desktop zu verwenden, fügen Sie Ihren Claude Desktop-Einstellungen die folgende Konfiguration hinzu:

{
   "mcpServers": {
      "personal-assistant": {
         "command": "/path/to/your/venv/bin/python",
         "args": ["/path/to/your/project/main.py"],
         "env": {
                 "GOOGLE_CREDENTIALS_PATH": "/path/to/your/credentials.json",
                 "GOOGLE_TOKEN_PATH": "/path/to/your/token.json",
                 "GOOGLE_API_KEY": "your_google_api_key",
                 "GOOGLE_CX_ID": "your_google_cx_id",
                 "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
                 "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder",
                 "TRELLO_API_KEY": "your_trello_api_key",
                 "TRELLO_TOKEN": "your_trello_token",
                 "LOG_PATH": "/path/to/log.txt",
                 "ENABLE_OBSIDIAN_TOOLS": "True/False",
                 "ENABLE_TRELLO_TOOLS": "True/False",
                 "ENABLE_CALENDAR_TOOLS": "True/False",
                 "ENABLE_NEWS_SEARCH": "True/False",
                 "ENABLE_WEB_PARSER": "True/False",
                 "SEMANTIC_SEARCH_ENABLED": "True/False",
                 "EMBEDDINGS_PATH": "/path/to/embeddings.json"
         }
      }
   }
}

Ersetzen Sie die Pfade und Anmeldeinformationen durch Ihre tatsächlichen Werte:

• command : Pfad zur ausführbaren Python-Datei Ihrer virtuellen Python-Umgebung

• args : Pfad zur main.py -Datei Ihres Projekts

• ENABLE_OBSIDIAN_TOOLS : Auf True setzen, um Obsidian-Tools zu aktivieren

• ENABLE_TRELLO_TOOLS : Auf True setzen, um Trello-Tools zu aktivieren

• ENABLE_CALENDAR_TOOLS : Auf True setzen, um Google Kalender-Tools zu aktivieren

• ENABLE_NEWS_SEARCH : Auf True setzen, um die Google News-Suche zu aktivieren

• ENABLE_WEB_PARSER : Auf True setzen, um das Webparser-Tool zu aktivieren

• GOOGLE_CREDENTIALS_PATH : Pfad zu Ihrer Google Kalender-Anmeldeinformationsdatei ( credentials.json )

• GOOGLE_TOKEN_PATH : Pfad zu Ihrer Google Kalender-Token-Datei ( token.json )

• GOOGLE_API_KEY : Ihr Google-API-Schlüssel (für die benutzerdefinierte Such-API)

• GOOGLE_CX_ID : Ihre programmierbare Google-Suchmaschinen-ID (CX-ID für die benutzerdefinierte Such-API)

• OBSIDIAN_VAULT_PATH : Pfad zu Ihrem Obsidian-Tresor

• OBSIDIAN_DEFAULT_FOLDER : Optionaler Pfad zum Standardordner in Ihrem Tresor, in dem neue Notizen erstellt werden

• TRELLO_API_KEY : Ihr Trello-API-Schlüssel

• TRELLO_TOKEN : Ihr Trello-API-Token

• LOG_PATH : Pfad zur Protokolldatei

• SEMANTIC_SEARCH_ENABLED : Auf True setzen, um die semantische Suche für Obsidian Vault zu aktivieren

• SIMILARITY_TRESHOLD : Der Standardwert ist 0,5, dies ist der Schwellenwert für die semantische Suche

• EMBEDDINGS_PATH : Optionaler Pfad zur vom Obsidian Vector Search-Plugin generierten Embeddings-JSON-Datei (standardmäßig .obsidian/plugins/vector-search/data.json relativ zu OBSIDIAN_VAULT_PATH , falls nicht festgelegt)

• MODEL_TOKEN_LIMIT : Grenzwert für das KI-Modell, um zu verstehen, wann die Notizen in Blöcke aufgeteilt werden sollen

• CHUNK_SIZE_TOKENS : Blockgröße

Um die semantischen Suchfunktionen zu aktivieren, müssen Sie das Vector Search-Plugin für Obsidian installieren.

Nachdem der Neuindizierungsprozess abgeschlossen ist, generiert das Plug-In eine JSON-Datei mit Vektoreinbettungen am folgenden Speicherort:

.obsidian/plugins/vector-search/data.json

Diese Datei wird als Einbettungsquelle für semantische Suchanfragen verwendet.

Empfohlene Kunden:

• Anthropischer Claude-Desktop

• 5ire

Entwicklung

• Das Projekt nutzt Poetry für das Abhängigkeitsmanagement

• Alle Tools sind in main.py registriert

• Dienstspezifische Implementierungen finden Sie im Verzeichnis services/

• Befolgen Sie die PEP 8-Stilrichtlinien für Python-Code

Beitragen

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature )

3. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add some amazing feature' )

4. Pushen zum Zweig ( git push origin feature/amazing-feature )

5. Öffnen einer Pull-Anfrage