Gemini MCP File Agent

Файловый агент Gemini MCP (MVP)

Этот проект позволяет вам общаться с искусственным интеллектом Gemini от Google и разрешать ему безопасно читать, записывать и перечислять файлы на вашем компьютере в определенной контролируемой папке («песочнице»).

Что он делает:

• mcp_server.py : Локальный сервер, который Gemini использует для доступа к файлам. Вы указываете ему, какая папка на вашем компьютере является «песочницей».
• Скрипты чата ( chat_with_gemini_mcp.py , simple_chat.py ) : чаты командной строки, в которых вы общаетесь с Gemini. Затем Gemini может использовать mcp_server.py для управления файлами в песочнице.

ИСПОЛЬЗУЙТЕ С ОСТОРОЖНОСТЬЮ: Это базовый пример. Будьте осторожны с тем, к какой папке вы даете доступ mcp_server.py .

Быстрый старт

1. Получить файлы: убедитесь, что все файлы .py находятся в одной папке.
2. API-ключ:
   • Получите ключ API Google AI от Google AI Studio .
   • Установите его как переменную среды:
     export GOOGLE_API_KEY="YOUR_KEY_HERE"
     (Для Windows используйте set GOOGLE_API_KEY="YOUR_KEY_HERE" )
3. Установка материалов:
   pip install -r requirements.txt
   (Или запустите ./install_packages.sh )
4. Запустите его:
   • Терминал 1: Запуск сервера MCP
     python mcp_server.py
     (По умолчанию создается и используется папка ./mcp_data_sandbox/ . Чтобы использовать другую папку: python mcp_server.py --sandbox-dir ./my_files )
   • Терминал 2: Начать чат
     python chat_with_gemini_mcp.py
5. Чат с Близнецами:
   • «Какие файлы находятся в моей рабочей папке?»
   • «Создайте notes.txt и напишите в нем «Привет, мир».
   • «Прочитать notes.txt ».

Как это работает (просто)

1. Вы общаетесь с Близнецами.
2. Если вы спросите о файлах, Gemini сообщит вашему чат-скрипту использовать «файловый инструмент».
3. Ваш скрипт чата сообщает mcp_server.py о необходимости выполнения действия с файлом (чтение, запись и т. д.) в папке sandbox.
4. Сервер делает это и сообщает чат-скрипту результат.
5. Скрипт чата сообщает Gemini результат.
6. Близнецы расскажут вам, что произошло.

Важный

• Только песочница: mcp_server.py может касаться ТОЛЬКО файлов внутри папки, которую вы выбрали в качестве песочницы. Это необходимо для безопасности.
• Локальное использование: предназначено для запуска на вашем собственном компьютере.

Это базовый инструмент для изучения предоставления доступа к файлам AI. Будьте умны в том, как вы его используете!