first gemini based desktop client for MCP
Gemini MCP Desktop Client is a desktop client built with Electron, Vite, React, and TypeScript, designed to interact with various Model Context Protocol (MCP) servers.
It also integrates Google's Gemini API to provide a powerful LLM chat experience.
To get started with Google Gemini API, you'll need to generate an API key. Follow the steps below to create the key and secure it for your project.
To generate a Google Gemini API key, follow the official guide from Merge Dev. You can access the instructions here: Google Gemini API Key Documentation.
This documentation will walk you through the process of creating and managing your API key.
git clone https://github.com/duke7able/gemini-mcp-desktop-client.git
cd gemini-mcp-desktop-client
npm install
To create .env run npm run create-env
for mac and unix and npm run create-env-win
for windows
Or simply create one like this
Create a .env
file in the root directory of the project with the following content:
PORT=5001 # Port for the backend API server
VITE_API_URL=http://localhost:5001
NODE_ENV="DEVELOPMENT"
Make sure to adjust
VITE_API_URL
if you run your backend server on a different port or domain.
To start the app in development mode:
npm run dev
This will start Vite and Electron in watch mode for live-reloading.
To create a production build:
npm run build
This will:
electron-builder
Output will be available inside the dist/
and dist-electron/
folders.
Script | Description |
---|---|
npm run dev | Start the app in development mode (Vite + Electron) |
npm run build | Build the app for production |
npm run preview | Preview the production Vite build |
npm run lint | Run ESLint on the codebase |
You can update your README.md
by adding a link to the mcpServerTested.md
file and a short explanation. Hereโs how you can insert it in the "MCP Servers" section of your README.md
:
This client is designed to interact with various MCP servers listed at:
๐ Model Context Protocol - Servers
There are many MCP servers available, including third-party MCP implementations integrated into this application.
However, I have created a separate list of tested and verified MCP servers to help users identify reliable options.
๐ See the list of tested MCP servers here: mcpServerTested.md
You can configure which server to connect to from within the app settings.
Let me know if you'd like this inserted automatically into your file or formatted differently.
This app uses Gemini to provide LLM-based chat inside the app.
Make sure you have your API key to configure app
/
โโโ dist/ # Vite frontend build output
โโโ dist-electron/ # Electron main process build output
โโโ static/ # Static assets
โโโ src/ # Source code (React + Electron)
โโโ package.json
โโโ vite.config.ts
โโโ electron-builder.yml
You can control whether DevTools are enabled in the Electron window directly from the electron/main.ts
file.
In the createWindow
function, modify the devTools
property inside the webPreferences
object to control this behavior:
devTools: false // Set to true to enable DevTools, false to disable
Additionally, you can programmatically open DevTools using:
win.webContents.openDevTools(); // Opens DevTools automatically when the app launches
function createWindow() {
const { width, height } = screen.getPrimaryDisplay().workAreaSize;
win = new BrowserWindow({
width,
height,
icon: path.join(process.env.VITE_PUBLIC, "electron-vite.svg"),
webPreferences: {
webSecurity: false,
preload: path.join(__dirname, "preload.mjs"),
contextIsolation: true,
nodeIntegration: true,
devTools: false, // โ
Change this to true or false as needed
},
});
if (VITE_DEV_SERVER_URL) {
win.loadURL(VITE_DEV_SERVER_URL);
} else {
win.loadFile(path.join(RENDERER_DIST, "index.html"));
}
// โ
Open DevTools automatically (only works if devTools is true)
win.webContents.openDevTools();
}
โ ๏ธ Ensure
devTools
is set totrue
inwebPreferences
if you wantopenDevTools()
to work. Otherwise, the DevTools will not open.
You can directly download and install the latest version of the Gemini MCP Desktop Client for your platform:
๐ช Windows Installer (MSI/EXE): Download for Windows
๐ macOS (DMG): Download for macOS
Steps to make it work for mac :
sudo xattr -rd com.apple.quarantine ~/Desktop/electron-mcp.app
.These are prebuilt installers using
electron-builder
and are ideal for users who donโt want to build the app manually.
No configuration available
Related projects feature coming soon
Will recommend related projects based on sub-categories