Agente asistente personal de MCP

Un agente de inteligencia artificial asistente personal versátil creado con el Protocolo de contexto de modelo (MCP) que ayuda con el calendario, las tareas, los correos electrónicos y más.

Descripción general

Este proyecto es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona un conjunto de herramientas para un agente de asistente personal. Se puede integrar con clientes MCP como Claude for Desktop para que los asistentes de IA puedan:

Administrar eventos del calendario
Seguimiento de tareas y tareas pendientes
Leer y enviar correos electrónicos
Busque en la web y recupere información
Controlar dispositivos domésticos inteligentes

Requisitos

⚠️ IMPORTANTE: Se requiere Python 3.10 o superior para el SDK de MCP. El servidor no funcionará con versiones anteriores de Python.

Python 3.10+
SDK de MCP 1.2.0+
Paquetes de Python necesarios (consulte requirements.txt)

Instalación

Clonar el repositorio:

git clone https://github.com/yourusername/mcp-pa-ai-agent.git
cd mcp-pa-ai-agent

Asegúrate de tener Python 3.10+:

python --version

Si su sistema Python es anterior a la versión 3.10, configure un entorno compatible:

# Using conda
conda create -n mcp-env python=3.10
conda activate mcp-env

# OR using venv (if Python 3.10+ is installed elsewhere)
python3.10 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Instalar dependencias:

pip install -r requirements.txt

Configure las variables de entorno copiando el archivo de ejemplo:

cp .env.example .env

Edite el archivo .env con sus credenciales y configuraciones de API.

Ejecución del servidor

Inicie el servidor MCP con:

python mcp_server.py

El servidor se iniciará y escuchará las conexiones del cliente MCP.

Conexión a Claude para escritorio

Instalar Claude para escritorio
Configure Claude for Desktop para utilizar este servidor MCP editando el archivo de configuración en:
- MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
Agregue la siguiente configuración:

{
  "mcpServers": {
    "personal-assistant": {
      "command": "/path/to/python",
      "args": [
        "/absolute/path/to/mcp-pa-ai-agent/mcp_server.py"
      ]
    }
  }
}

Si está utilizando un entorno virtual, asegúrese de apuntar el ejecutable de Python en ese entorno.

Reiniciar Claude para escritorio

Herramientas disponibles

Calendario

get_events : recupera los próximos eventos del calendario
create_event : Programar un nuevo evento del calendario

Tareas

list_tasks : Ver todas las tareas o filtrar por estado
add_task : Crea una nueva tarea
update_task_status : Marcar tareas como pendientes, en progreso o completadas

Correo electrónico

get_emails : Lista los correos electrónicos recientes de tu bandeja de entrada
read_email : Ver el contenido completo de un correo electrónico específico
send_email : Redactar y enviar un nuevo correo electrónico

Conocimiento

web_search : Busca información en la web
get_weather : Obtenga información meteorológica actual
get_news : Recuperar los últimos artículos de noticias

Casa inteligente

list_devices : Ver todos los dispositivos domésticos inteligentes
control_device : Controla dispositivos domésticos inteligentes (luces, termostatos, etc.)
get_device_state : obtener información detallada sobre el estado actual de un dispositivo

Configuración

El servidor requiere varias claves API y credenciales para acceder a diferentes servicios:

API de Google : para funciones de calendario y correo electrónico (credenciales OAuth2)
API meteorológica : para obtener información meteorológica
API de noticias : para la recuperación de noticias
Home Assistant : para el control inteligente del hogar

Consulte el archivo .env.example para conocer todas las opciones configurables.

Solución de problemas

Problemas con la versión de Python

Si ves un error como:

Error: Python 3.10 or higher is required for the MCP server.

Necesita actualizar su versión de Python o utilizar un entorno virtual con Python 3.10+.

Problemas de instalación del SDK de MCP

Si tiene problemas al instalar el SDK de MCP:

ERROR: Could not find a version that satisfies the requirement mcp>=1.2.0

Asegúrate de estar usando Python 3.10+ y que pip esté actualizado:

pip install --upgrade pip

Desarrollo

Para agregar nueva funcionalidad al servidor, puede:

Crea un nuevo módulo en el directorio modules/
Implementar funciones con el decorador @mcp.tool()
Importa tu módulo en mcp_server.py

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de protocolo de contexto de modelo versátil que permite a los asistentes de IA administrar calendarios, realizar un seguimiento de tareas, manejar correos electrónicos, buscar en la web y controlar dispositivos domésticos inteligentes.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Home Assistant MCP Server
miguelg719
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.
Last updated -
Python
MIT License
Hass-MCP
voska
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.
Last updated -
104
Python
MIT License
Notion MCP Server
emmanuelsystems
A
security
F
license
A
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
12
194
JavaScript
Bluesky MCP Server
brianellin
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.
Last updated -
18
10
TypeScript

View all related MCP servers

MCP Personal Assistant Agent