Overview
Gemini MCP Server is an implementation of the Model Context Protocol (MCP) that allows Claude Desktop to interact seamlessly with Google's Gemini AI models.
To use the Gemini MCP Server, you need to obtain a Gemini API key, configure your Claude Desktop settings, and restart the application to enable the integration.
- Full MCP protocol support for enhanced AI interactions - Real-time response streaming for immediate feedback - Secure handling of API keys through environment variables - Configurable model parameters for tailored AI performance - Built using TypeScript for robust development
- Integrating Gemini AI capabilities into desktop applications
- Enabling real-time AI responses in user interfaces
- Customizing AI model parameters for specific tasks
Add to your AI client
Use these steps to connect Gemini MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"aliargun-mcp-server-gemini-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aliargun-mcp-server-gemini-mcp-mirror"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"aliargun-mcp-server-gemini-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aliargun-mcp-server-gemini-mcp-mirror"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"aliargun-mcp-server-gemini-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aliargun-mcp-server-gemini-mcp-mirror"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"aliargun-mcp-server-gemini-mcp-mirror": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aliargun-mcp-server-gemini-mcp-mirror"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"aliargun-mcp-server-gemini-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aliargun-mcp-server-gemini-mcp-mirror"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"aliargun-mcp-server-gemini-mcp-mirror": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-aliargun-mcp-server-gemini-mcp-mirror"
]
}
}
}FAQ
How do I get a Gemini API key?
You can obtain a Gemini API key by visiting Google AI Studio and creating a new API key.
What platforms does Gemini MCP Server support?
Gemini MCP Server is designed to work with Claude Desktop on Mac, Windows, and Linux.
Is there a guide for troubleshooting common issues?
Yes! A detailed troubleshooting guide is available in the documentation.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":694,"uuid":"b7683430-6c5b-4e40-9822-e394f2206817","name":"aliargun_mcp-server-gemini","title":"Gemini MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T03:26:34.198Z","updated_at":"2025-02-23T07:16:02.911Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"mcp-server,gemini,AI-integration","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/aliargun_mcp-server-gemini","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]