GemCP Chat

The GemCP app is a cross-platform desktop application that creates a seamless chat interface for Google's Gemini AI models with extensible capabilities through a Model Context Protocol (MCP) framework.

• 🤖 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.

Example of the weather tool in action

Main chat interface with Gemini

Using the calculator tool with Gemini

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

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

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

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

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

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

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.

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

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

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

• 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

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

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