Gemini MCP File Agent (MVP)
@kevingduck
About Gemini MCP File Agent (MVP)
Simple chat interface and server for testing Gemini MCP
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"gemini_mcp": {
"command": "python",
"args": [
"mcp_server.py"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Gemini MCP File Agent (MVP)?
It is a local server and chat scripts that allow Google's Gemini AI to safely read, write, and list files on your computer within a specific, controlled folder (a sandbox). It is intended for developers exploring AI file access.
How to use Gemini MCP File Agent (MVP)?
Install the Python packages, set your Google AI API key as the GOOGLE_API_KEY environment variable, then run mcp_server.py (optionally with --sandbox-dir) in one terminal and chat_with_gemini_mcp.py in another. You can then ask Gemini about files in the sandbox.
Key features of Gemini MCP File Agent (MVP)
- Safe file access limited to a sandbox folder.
- Command-line chat interface with Gemini.
- Can read, write, and list files.
- Uses a local MCP server (
mcp_server.py). - Designed for local, single‑computer use.
Use cases of Gemini MCP File Agent (MVP)
- Ask Gemini what files are in your work folder.
- Have Gemini create a file and write content to it.
- Have Gemini read the contents of an existing file.
- Explore giving an AI controlled file access.
FAQ from Gemini MCP File Agent (MVP)
What is the sandbox?
The sandbox is a specific folder you choose (default: ./mcp_data_sandbox/). The server can only touch files inside that folder for safety.
Why do I need an API key?
You need a Google AI API key from Google AI Studio to use Gemini. Set it as the environment variable GOOGLE_API_KEY.
Can Gemini access files outside the sandbox?
No. The mcp_server.py is designed to only access files inside the folder you pick as the sandbox.
How do I use a different sandbox folder?
Run python mcp_server.py --sandbox-dir ./my_files to use a custom folder instead of the default ./mcp_data_sandbox/.
Is this safe for production use?
No. The README states this is a basic example and cautions you to be careful about which folder the server accesses.
More AI & Agents MCP servers
MCP Claude Code
SDGLBLMCP implementation of Claude Code capabilities and more
Model Context Protocol for Unreal Engine
chongdashuEnable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
Model Context Protocol Server for Home Assistant
tevonsbA MCP server for Home Assistant
Gemini MCP Server
aliargunMCP server implementation for Google's Gemini API
欢迎来到 智言平台
Shy2593666979AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。
Comments