Gemini MCP File Agent

Agente de archivos MCP de Gemini (MVP)

Este proyecto te permite chatear con la inteligencia artificial Gemini de Google y permitirle leer, escribir y enumerar archivos de forma segura en tu computadora dentro de una carpeta específica y controlada (una "caja de arena").

Qué hace:

• mcp_server.py : Un servidor local que Gemini usa para acceder a los archivos. Le indicas qué carpeta de tu computadora es la "zona de pruebas".
• Scripts de chat ( chat_with_gemini_mcp.py , simple_chat.py ) : Chats de línea de comandos donde se habla con Gemini. Gemini puede usar mcp_server.py para administrar archivos en el entorno de pruebas.

PRECAUCIÓN: Este es un ejemplo básico. Tenga cuidado con la carpeta a la que permite el acceso mcp_server.py .

Inicio rápido

1. Obtener archivos: asegúrese de que todos los archivos .py estén en una carpeta.
2. Clave API:
   • Obtén una clave API de Google AI desde Google AI Studio .
   • Establezcalo como una variable de entorno:
     export GOOGLE_API_KEY="YOUR_KEY_HERE"
     (Para Windows, utilice set GOOGLE_API_KEY="YOUR_KEY_HERE" )
3. Instalar cosas:
   pip install -r requirements.txt
   (O ejecute ./install_packages.sh )
4. Ejecutarlo:
   • Terminal 1: Iniciar el servidor MCP
     python mcp_server.py
     (Esto crea y usa una carpeta ./mcp_data_sandbox/ de manera predeterminada. Para usar una carpeta diferente: python mcp_server.py --sandbox-dir ./my_files )
   • Terminal 2: Iniciar chat
     python chat_with_gemini_mcp.py
5. Chatea con Géminis:
   • "¿Qué archivos hay en mi carpeta de trabajo?"
   • "Crea notes.txt y escribe 'Hola mundo' en él".
   • "Lea notes.txt ."

Cómo funciona (simplemente)

1. Charlas con Géminis.
2. Si preguntas acerca de archivos, Gemini le dice a tu script de chat que use una "herramienta de archivos".
3. Su script de chat le dice a mcp_server.py que realice la acción del archivo (leer, escribir, etc.) en la carpeta sandbox.
4. El servidor lo hace y le dice al script de chat el resultado.
5. El script de chat le dice a Gemini el resultado.
6. Géminis te cuenta lo que pasó.

Importante

• Solo en entorno de pruebas: mcp_server.py solo puede acceder a los archivos dentro de la carpeta seleccionada como entorno de pruebas. Esto es por seguridad.
• Uso local: diseñado para ejecutarse en su propia computadora.

Esta es una herramienta básica para explorar el acceso a archivos de IA. ¡Úsala con inteligencia!