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

Related MCP server: Gemini CLI MCP Server

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!