Gemini MCP File Agent

제미니 MCP 파일 에이전트(MVP)

이 프로젝트를 통해 Google의 Gemini AI와 채팅하고, 특정 제어 폴더("샌드박스") 내에서 컴퓨터의 파일을 안전하게 읽고, 쓰고, 나열할 수 있습니다.

기능:

• mcp_server.py : Gemini가 파일에 액세스하는 데 사용하는 로컬 서버입니다. 컴퓨터의 어느 폴더를 "샌드박스"로 설정할지 지정하세요.
• 채팅 스크립트( chat_with_gemini_mcp.py , simple_chat.py ) : Gemini와 대화하는 명령줄 채팅입니다. Gemini는 mcp_server.py 를 사용하여 샌드박스의 파일을 관리할 수 있습니다.

주의해서 사용하세요: 이는 기본적인 예시입니다. mcp_server.py 가 어떤 폴더에 접근할지 신중하게 결정하세요.

빠른 시작

1. 파일 가져오기: 모든 .py 파일이 하나의 폴더에 있는지 확인하세요.
2. API 키:
   • Google AI Studio에서 Google AI API 키를 받으세요.
   • 환경 변수로 설정하세요:지엑스피1(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 만들고 그 안에 'Hello world'를 쓰세요."
   • " notes.txt 읽어보세요."

작동 원리(간단히)

1. 당신은 쌍둥이자리와 채팅합니다.
2. 파일 관련 질문을 하면 제미니는 채팅 스크립트에 "파일 도구"를 사용하라고 지시합니다.
3. 채팅 스크립트는 mcp_server.py 에 샌드박스 폴더에서 파일 작업(읽기, 쓰기 등)을 수행하라고 지시합니다.
4. 서버가 이를 실행하고 채팅 스크립트에 결과를 알려줍니다.
5. 채팅 스크립트는 제미니에게 결과를 알려줍니다.
6. 쌍둥이자리가 무슨 일이 일어났는지 말해줍니다.

중요한

• 샌드박스 전용: mcp_server.py 는 샌드박스로 선택한 폴더 내의 파일만 접근할 수 있습니다. 이는 보안을 위한 조치입니다.
• 로컬 사용: 사용자의 컴퓨터에서 실행되도록 설계되었습니다.

AI에 파일 접근 권한을 부여하는 기본적인 도구입니다. 현명하게 사용하세요!