Gemini MCP File Agent (MVP)

Gemini 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 ファイルが 1 つのフォルダーにあることを確認します。

2. API キー：

   • Google AI Studio から 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. Gemini とチャットします。
2. ファイルについて尋ねると、Gemini はチャットスクリプトに「ファイルツール」を使うよう指示します。
3. チャットスクリプトは mcp_server.py に指示し、サンドボックスフォルダー内でファイル操作（読み取り、書き込みなど）を実行させます。
4. サーバーが操作を実行し、その結果をチャットスクリプトに伝えます。
5. チャットスクリプトが結果を Gemini に伝えます。
6. Gemini が何が起きたかをあなたに伝えます。

重要

• サンドボックス内のみ：mcp_server.py が操作できるのは、サンドボックスとして選択したフォルダー内のファイルのみです。安全のための制限です。
• **ローカルでの使用：**ご自身のコンピューターで実行することを想定しています。

これは、AI にファイルアクセスを許可する方法を試すための基本的なツールです。賢く使いましょう！