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):

   • Ir al portal para desarrolladores de Trello

   • Obtenga su clave API y token

   • Agréguelos a sus variables de entorno o archivo de configuración

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:

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.

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:

• Escritorio antrópico de Claude

• 5ire

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