Skip to main content
Glama
Sign In
deenesjakoruzh

Personal Assistant MCP Server

by lemannrus
GitHub
Python
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Create, read, update, and delete calendar events; list upcoming events

  • Create, read, update, and delete notes; perform full-text search; manage folders (create, delete, search, list)

  • Manage boards, lists, and cards; create, update, and delete cards; search cards by text query

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

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:

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

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Eine einheitliche Schnittstelle zur Verwaltung des digitalen Lebens durch Integrationen mit Google Kalender, Obsidian Vault, Trello und Funktionen zum Parsen von Webseiten.

  1. Merkmale
    1. Voraussetzungen
      1. Installation
        1. Konfiguration
          1. Verwendung
            1. Anthropic Claude Desktop-Konfiguration
              1. Empfohlene Kunden:
                1. Entwicklung
                  1. Beitragen

                    Related MCP Servers

                    • Google Calendar

                      GongRzhe
                      -
                      security
                      F
                      license
                      -
                      quality
                      Google Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                      Last updated -
                      5
                      0
                      5
                      JavaScript

                    • Calendar AutoAuth MCP Server

                      GongRzhe
                      -
                      security
                      A
                      license
                      -
                      quality
                      Server for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                      Last updated -
                      22
                      6
                      JavaScript
                      MIT License

                    • Webflow MCP Server

                      kapilduraphe
                      A
                      security
                      A
                      license
                      A
                      quality
                      Enables Claude to interact with Webflow's APIs for managing sites, retrieving information, and executing tasks using natural language.
                      Last updated -
                      2
                      4
                      TypeScript
                      MIT License
                      • Apple
                      • Linux

                    • Google Calendar MCP Server

                      takumi0706
                      -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.
                      Last updated -
                      133
                      21
                      TypeScript
                      MIT License

                    View all related MCP servers

                    New MCP Servers

                    ID: rtwik9l6bl