Servidor MCP del Asistente Personal

Un potente servidor de asistente personal que se integra con diversos servicios, como Google Calendar, Obsidian Vault, Trello y funciones de análisis de páginas web. Desarrollado con FastMCP, este servidor proporciona una interfaz unificada para gestionar tu vida digital.

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

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

Clonar el repositorio:
git clone https://github.com/yourusername/personal-assistant-mcp.git cd personal-assistant-mcp
Instalar dependencias usando Poetry:
poetry install
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
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

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

Iniciar el servidor:
poetry run python main.py
El servidor se iniciará y estará listo para aceptar conexiones de cliente compatibles con MCP.
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",
                 "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault",
                 "OBSIDIAN_DEFAULT_FOLDER": "your_default_folder",
                 "LOG_PATH": "/path/to/log.txt",
                 "TRELLO_TOKEN": "your_trello_token",
                 "TRELLO_API_KEY": "your_trello_api_key"
         }
      }
   }
}

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
GOOGLE_CREDENTIALS_PATH : Ruta a su archivo de credenciales de Google Calendar
GOOGLE_TOKEN_PATH : Ruta a su archivo de token de Google Calendar
OBSIDIAN_VAULT_PATH : Ruta a tu bóveda de obsidiana
OBSIDIAN_DEFAULT_FOLDER : Ruta a la carpeta predeterminada en su bóveda donde se crearán nuevas notas
TRELLO_TOKEN : Su token de API de Trello
TRELLO_API_KEY : Su clave API de Trello

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

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Unirse:

Blog de Telegram

Personal Assistant MCP Server

Integrations