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

Related MCP server: Agentic Tools MCP Server

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

1. Clonar el repositorio:

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

2. Asegúrate de tener Python 3.10+:

python --version

3. 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

4. Instalar dependencias:

pip install -r requirements.txt

5. Configure las variables de entorno copiando el archivo de ejemplo:

cp .env.example .env

6. 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

1. Instalar Claude para escritorio

2. 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

3. 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.

4. 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:

1. Crea un nuevo módulo en el directorio modules/

2. Implementar funciones con el decorador @mcp.tool()

3. 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.