Skip to main content
Glama

Personal Assistant MCP Server

by lemannrus

Nexus MCP

Características

  • Integración con Google Calendar
    • Crear, leer, actualizar y eliminar eventos del calendario
    • Lista de próximos eventos
  • Gestión de la bóveda de obsidiana
    • Crear, leer, actualizar y eliminar notas
    • Búsqueda de texto completo en notas
    • Gestión de carpetas (crear, eliminar, buscar, listar)
  • Integración con Trello
    • Gestión de tableros, listas y tarjetas
    • Crear, actualizar y eliminar tarjetas
    • Buscar tarjetas por consulta de texto
  • Análisis de páginas web
    • Extrae y limpia contenido HTML de cualquier URL
  • Búsqueda de noticias de Google
    • Buscar artículos de noticias recientes sobre un tema determinado

Únete a mí en Telegram y Blog

Prerrequisitos

  • Python 3.10 o superior
  • Poesía (gestor de paquetes de Python)
  • Credenciales de la API de Google Calendar
  • Credenciales de la API de Trello (si se utilizan las funciones de Trello)
  • Bóveda de obsidiana (si se utilizan funciones de obsidiana)

Instalación

  1. Clonar el repositorio:
    git clone https://github.com/yourusername/nexus-mcp.git cd nexus-mcp
  2. Instalar dependencias usando Poetry:
    poetry install
  3. Configurar la API de Google Calendar:
    • Vaya a la consola de Google Cloud
    • Crea un nuevo proyecto o selecciona uno existente
    • Habilitar la API de Google Calendar
    • Crear credenciales OAuth 2.0
    • Descargue las credenciales y guárdelas como credentials.json en la raíz del proyecto
  4. Configurar la API de Trello (opcional):

Configuración

  1. Ejecute la configuración inicial para autenticarse con Google Calendar:
    poetry run python main.py
    • Esto abrirá una ventana del navegador para la autenticación de Google.
    • Siga las instrucciones para autorizar la aplicación.

Uso

  1. Iniciar el servidor:
    poetry run python main.py
  2. El servidor se iniciará y estará listo para aceptar conexiones de cliente compatibles con MCP.
  3. Utilice cualquier cliente compatible con MCP para interactuar con el servidor. El servidor proporciona las siguientes herramientas:
    • Gestión del calendario
    • Operaciones de la bóveda de obsidiana
    • Gestión del tablero de Trello
    • Análisis de páginas web

Configuración del escritorio de Anthropic Claude

Para utilizar este servidor con Anthropic Claude Desktop, agregue la siguiente configuración a la configuración de Claude Desktop:

{ "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" } } } }

Reemplace las rutas y credenciales con sus valores reales:

  • command : Ruta al ejecutable de Python de su entorno virtual Python
  • args : Ruta al archivo main.py de su proyecto
  • ENABLE_OBSIDIAN_TOOLS : Establézcalo en True para habilitar las herramientas de Obsidian
  • ENABLE_TRELLO_TOOLS : Establézcalo en True para habilitar las herramientas de Trello
  • ENABLE_CALENDAR_TOOLS : Establézcalo en True para habilitar las herramientas de Google Calendar
  • ENABLE_NEWS_SEARCH : Establézcalo en True para habilitar la búsqueda de Google Noticias
  • ENABLE_WEB_PARSER : Establezca en True para habilitar la herramienta de análisis web
  • GOOGLE_CREDENTIALS_PATH : Ruta a su archivo de credenciales de Google Calendar ( credentials.json )
  • GOOGLE_TOKEN_PATH : Ruta a su archivo de token de Google Calendar ( token.json )
  • GOOGLE_API_KEY : Su clave API de Google (para la API de búsqueda personalizada)
  • GOOGLE_CX_ID : Su ID de motor de búsqueda programable de Google (ID de CX para API de búsqueda personalizada)
  • OBSIDIAN_VAULT_PATH : Ruta a tu bóveda de obsidiana
  • OBSIDIAN_DEFAULT_FOLDER : Ruta opcional a la carpeta predeterminada en su bóveda donde se crearán nuevas notas
  • TRELLO_API_KEY : Su clave API de Trello
  • TRELLO_TOKEN : Su token de API de Trello
  • LOG_PATH : Ruta al archivo de registro
  • SEMANTIC_SEARCH_ENABLED : Establézcalo en True para habilitar la búsqueda semántica para Obsidian Vault
  • EMBEDDINGS_PATH : Ruta opcional al archivo json de incrustaciones generado por el complemento Obsidian Vector Search (el valor predeterminado es .obsidian/plugins/vector-search/data.json en relación con OBSIDIAN_VAULT_PATH si no está configurado)

Para habilitar las capacidades de búsqueda semántica, necesitará instalar el complemento Vector Search para Obsidian.

img.png

Una vez completado el proceso de reindexación, el complemento generará un archivo JSON que contiene incrustaciones vectoriales en la siguiente ubicación:

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

Este archivo se utilizará como fuente de inserción para consultas de búsqueda semántica.

Clientes recomendados:

Desarrollo

  • El proyecto utiliza Poetry para la gestión de dependencias.
  • Todas las herramientas están registradas en main.py
  • Las implementaciones específicas del servicio se encuentran en el directorio services/
  • Siga las pautas de estilo PEP 8 para el código Python

Contribuyendo

  1. Bifurcar el repositorio
  2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
  3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
  4. Empujar a la rama ( git push origin feature/amazing-feature )
  5. Abrir una solicitud de extracción
-
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.

Una interfaz unificada para gestionar la vida digital a través de integraciones con Google Calendar, Obsidian Vault, Trello y capacidades de análisis de páginas web.

  1. Características
    1. Prerrequisitos
      1. Instalación
        1. Configuración
          1. Uso
            1. Configuración del escritorio de Anthropic Claude
              1. Clientes recomendados:
                1. Desarrollo
                  1. Contribuyendo

                    Related MCP Servers

                    • -
                      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
                    • -
                      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
                    • 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
                    • -
                      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

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/lemannrus/personal-assistant-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server