Gemini MCP 文件代理

Gemini MCP 文件代理 (MVP)

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

它的作用：

**mcp_server.py**用于访问文件的本地服务器。你需要指定计算机上哪个文件夹是“沙盒”。
聊天脚本（ chat_with_gemini_mcp.py 、 simple_chat.py ） ：用于与 Gemini 对话的命令行聊天脚本。Gemini 可以使用mcp_server.py管理沙盒中的文件。

**谨慎使用：**这是一个基本示例。请谨慎选择允许mcp_server.py访问的文件夹。

**获取文件：**确保所有.py文件都在一个文件夹中。
API密钥：
- 从Google AI Studio获取 Google AI API 密钥。
- 将其设置为环境变量：
  export GOOGLE_API_KEY="YOUR_KEY_HERE"
  （对于 Windows，使用set GOOGLE_API_KEY="YOUR_KEY_HERE" ）
安装内容：
pip install -r requirements.txt
（或者运行./install_packages.sh ）
运行它：
- 终端 1：启动 MCP 服务器
  python mcp_server.py
  （此操作默认创建并使用./mcp_data_sandbox/文件夹。要使用其他文件夹： python mcp_server.py --sandbox-dir ./my_files ）
- 2号航站楼：开始聊天
  python chat_with_gemini_mcp.py
与双子座聊天：
- “我的工作文件夹中有哪些文件？”
- “创建notes.txt并在其中写入‘Hello world’。”
- “阅读notes.txt 。”

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

security - not tested

license - not found

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

本地服务器使 Google 的 Gemini AI 能够通过自然语言聊天交互安全地读取、写入和列出计算机上受控沙盒文件夹中的文件。