Gemini文件代理

Gemini MCP文件代理（MVP）

该项目允许您与谷歌的Gemini AI聊天，并允许它在特定的受控文件夹（“沙盒”）中安全地读取、写入和列出计算机上的文件。

它的作用：

• mcp_server.py：Gemini用于访问文件的本地服务器。你告诉它你电脑上的哪个文件夹是“沙盒”
• 聊天脚本(chat_with_gemini_mcp.py, simple_chat.py)：命令行聊天，您可以在其中与Gemini交谈。双子座可以使用 mcp_server.py 管理沙盒中的文件。

小心使用： 这是一个基本的例子。小心你让哪个文件夹 mcp_server.py 访问。

快速开始

1. 获取文件： 确保所有 .py 文件在一个文件夹中。

2. API密钥：

   • 从获取Google AI API密钥 谷歌人工智能工作室.
   • 将其设置为环境变量：
     复制

     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. 与Gemini聊天：

   • “我的工作文件夹中有哪些文件？”
   • “创建 notes.txt 并在其中写下“Hello world”。”
   • “阅读 notes.txt."

它是如何工作的（简单）

1. 你和双子座聊天。
2. 如果你问文件，Gemini告诉你的聊天脚本使用“文件工具”
3. 您的聊天脚本告诉 mcp_server.py 在沙盒文件夹中执行文件操作（读取、写入等）。
4. 服务器执行此操作，并将结果告诉聊天脚本。
5. 聊天脚本告诉双子结果。
6. 双子告诉你发生了什么事。

重要

• 仅限沙盒： 这 mcp_server.py 只能触摸您选择作为沙盒的文件夹中的文件。这是为了安全。
• 本地使用： 设计用于在您自己的计算机上运行。

这是一个探索授予AI文件访问权限的基本工具。明智地使用它！