Asistente local de SO y segundo cerebro (MCP y OpenAI)

Un asistente de escritorio local autónomo y multiplataforma impulsado por el Protocolo de Contexto de Modelo (MCP) y OpenAI (gpt-4o). Ejecuta comandos del sistema local de forma segura, lee y escribe archivos, supervisa diagnósticos de hardware y recuerda el contexto de proyectos entre sesiones mediante una base de datos SQLite local (brain.db).

Características

• Servidor FastMCP (server.py):

  • read_local_file: Lee de forma segura el contenido de texto de archivos locales.

  • write_local_file: Escribe contenido en archivos locales, creando automáticamente los directorios que falten.

  • list_directory: Inspección de directorios con formato, incluyendo tamaño y tipo de archivo.

  • execute_terminal_command: Ejecuta comandos de shell con salvaguardas de seguridad para palabras clave destructivas (rm, del, rmdir, format, drop).

  • open_application_or_url: Lanza aplicaciones de escritorio o abre URLs en el navegador web predeterminado en múltiples plataformas (Windows, macOS, Linux).

  • get_system_metrics: Obtiene diagnósticos en tiempo real de CPU, RAM, disco y batería usando psutil.

  • save_memory: Persiste notas del usuario, contexto de pila de proyectos y preferencias en la base de datos SQLite brain.db.

  • search_memory: Búsqueda de texto completo/patrones en las memorias almacenadas.

• Asistente de terminal interactivo (client.py):

  • Descubrimiento dinámico de herramientas mediante transporte stdio de MCP.

  • Hidratación de memoria al inicio desde brain.db.

  • Prompt REPL de CLI persistente (You > / Brain > ).

• Listo para Claude Desktop (claude_desktop_config.json):

  • Archivo de configuración listo para usar para la integración con Claude Desktop.

Related MCP server: notion-local-ops-mcp

Instalación y configuración

Requisitos previos

• Python 3.10 o superior.

• Una clave de API de OpenAI (OPENAI_API_KEY).

1. Configurar el entorno virtual

Navegue al directorio raíz del proyecto y cree un entorno virtual:

# Windows
python -m venv venv
venv\Scripts\activate

# macOS / Linux
python3 -m venv venv
source venv/bin/activate

2. Instalar dependencias

Instale las dependencias fijadas desde requirements.txt:

pip install -r requirements.txt

3. Configuración del entorno

Cree un archivo .env en el directorio raíz del proyecto o establezca la variable de entorno:

OPENAI_API_KEY=your_openai_api_key_here

Ejecutar el asistente

Opción A: Cliente CLI interactivo

Inicie el terminal del asistente interactivo:

python client.py

Ejemplo de sesión:

You > Save a memory under key 'favorite_editor' value 'VS Code with Vim binding' tags ['preference', 'tools']
Brain > I've stored your preference for VS Code with Vim binding in the brain database.

You > What are my current system metrics?
Brain > Your system is running at 15.4% CPU usage with 12.2 GB / 32 GB RAM used and 78% battery remaining.

Opción B: Integrar con Claude Desktop

Para usar este servidor MCP local con Claude Desktop, agregue la configuración de claude_desktop_config.json a su archivo de configuración de Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Agregue la definición del servidor:

{
  "mcpServers": {
    "local-os-brain": {
      "command": "python",
      "args": [
        "C:/Users/acer/.gemini/antigravity-ide/scratch/mcp_local_brain/server.py"
      ]
    }
  }
}

Nota: Reemplace "python" con la ruta absoluta al ejecutable de Python de su entorno virtual si usa un venv.

Estructura del proyecto

mcp_local_brain/
├── brain.db                      # SQLite database auto-generated on first run
├── server.py                    # FastMCP Server with OS & Brain Tools
├── client.py                    # Interactive Terminal AI Assistant
├── claude_desktop_config.json   # Claude Desktop configuration snippet
├── requirements.txt             # Pinned python dependencies
└── README.md                    # Documentation & Setup Guide

Licencia

MIT