Gemini MCP Server
MCP server implementation for Google's Gemini API
Overview
Gemini MCP Server is a Model Context Protocol server implementation that enables Claude Desktop to interact seamlessly with Google's Gemini AI models.
To use the Gemini MCP Server, acquire an API key from Google AI Studio, configure your Claude Desktop settings with the server parameters, and then restart Claude Desktop to enable the interaction with Gemini models.
- Full MCP protocol support - Real-time response streaming - Secure handling of API keys - Configurable model parameters - Written in TypeScript for performance and maintainability
- Connecting Claude Desktop to Gemini AI for enhanced AI interactions
- Utilizing advanced AI models for various applications like chatbots and virtual assistants
- Developing and testing applications that leverage real-time AI responses
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": {
"mcp-server-gemini-aliargun": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-gemini-aliargun"
]
}
}
}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": {
"mcp-server-gemini-aliargun": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-gemini-aliargun"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-gemini-aliargun": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-gemini-aliargun"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-gemini-aliargun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-gemini-aliargun"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-gemini-aliargun": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-gemini-aliargun"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-gemini-aliargun": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-gemini-aliargun"
]
}
}
}FAQ
Is there an API key required for using this server?
Yes! You must obtain an API key from Google AI Studio to authenticate your requests.
What if I encounter connection issues?
Check if port 3005 is available and ensure that your internet connection is stable. Refer to the Troubleshooting Guide for more details.
Can I contribute to the development?
Absolutely! Contributions are welcome, and you can follow the guidelines in the Contributing Guide.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":422,"uuid":"76716869-5762-4b1a-95ab-2774c288dc59","name":"mcp-server-gemini","title":"Gemini MCP Server","description":"MCP server implementation for Google's Gemini API","avatar_url":"https://avatars.githubusercontent.com/u/184430617?v=4","created_at":"2024-12-16T07:21:58.704Z","updated_at":"2024-12-19T12:38:17.773Z","status":"created","author_name":"aliargun","author_avatar_url":"https://avatars.githubusercontent.com/u/184430617?v=4","tags":"gemini,mcp-server,google-api","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/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"}]]}]