kkrishnan90/gemini-desktop

✨ Features

• 🤖 Gemini Integration: Seamless chat interface with Google’s Gemini models (configurable via Settings).
• 🔧 Extensible Tools (MCP): Connect external tools and data sources via the Model Context Protocol.
  • Supports Python-based MCP servers (added via file path).
  • Supports command-based MCP servers (e.g., Node.js) defined in a JSON configuration file.
• 🖥️ Cross-Platform: Runs on macOS and Windows (Electron build).
• 📊 Tool Status UI: Provides visual feedback when Gemini is calling an MCP tool and whether it succeeded or failed.
• ⚙️ Model Selection: Choose different Gemini models (e.g., 1.5 Flash, 1.5 Pro, 2.5 Pro Exp) through the Settings dialog.
• 📝 Markdown & LaTeX Rendering: Displays AI responses with formatting.

Screenshots

Example of the weather tool in action

Main chat interface with Gemini

Using the calculator tool with Gemini

Overview

This repository contains both a Python backend and an Electron-based desktop application for interacting with Gemini.

Project Structure

• mcp-gemini-desktop/: Frontend Electron application
• python_backend/: Python backend server

Running the Python Backend

Prerequisites

• Python 3.13+ (as specified in pyproject.toml)
• uv (Modern Python package installer and resolver)

Setup

1. Navigate to the Python backend directory:

   cd python_backend
   

2. Install uv if you don’t have it already:

   pip install uv
   

3. Install the required dependencies using uv:

   uv pip install .
   

4. Set your Google API key as an environment variable:

   # For Linux/macOS
   export GOOGLE_API_KEY=your_api_key_here
   
   # For Windows
   set GOOGLE_API_KEY=your_api_key_here
   

5. Start the Python backend server:

   python main.py
   

   The server should start running on http://localhost:5000

Running the Frontend Electron App

Prerequisites

• Node.js (v16+)
• npm (Node package manager)

Setup

1. Navigate to the Electron app directory:

   cd mcp-gemini-desktop
   

2. Install the required dependencies:

   npm install
   

3. Start the Electron app in development mode:

   npm start
   

Building the App

To build the Electron app for your platform:

cd mcp-gemini-desktop
npm run build

This will create platform-specific binaries in the dist folder.

Using Pre-built Binaries

If you prefer to use pre-built binaries directly:

1. Navigate to the mcp-gemini-desktop/dist directory
2. For macOS: Install the .dmg file
3. For Windows: Run the .exe installer

Available Binaries

• macOS (Apple Silicon): GemCP Chat-0.1.0-arm64.dmg
• Windows: Check the dist folder for .exe files

Example Servers

The repository includes example server implementations in mcp-gemini-desktop/mcp_example_servers/:

• mcp_server_calc.py: Calculator server example
• mcp_server_weather.py: Weather information server example

Troubleshooting

• Ensure the Python backend is running before starting the Electron app
• Check that your Google API key is correctly set
• Verify that the required ports are not blocked by a firewall

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Please raise PR for any contributions. Any PR raised will be reviewed and merged with the main branch.