Файловый агент 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 ».

Related MCP server: MCP Gemini Server

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

1. Вы общаетесь с Близнецами.

2. Если вы спросите о файлах, Gemini сообщит вашему чат-скрипту использовать «файловый инструмент».

3. Ваш скрипт чата сообщает mcp_server.py о необходимости выполнения действия с файлом (чтение, запись и т. д.) в папке sandbox.

4. Сервер делает это и сообщает чат-скрипту результат.

5. Скрипт чата сообщает Gemini результат.

6. Близнецы расскажут вам, что произошло.

Важный

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

• Локальное использование: предназначено для запуска на вашем собственном компьютере.

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