MCP Gemini Server

@MCP-Mirror

About MCP Gemini Server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bsmi021_mcp-gemini-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@bsmi021/mcp-gemini-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Gemini Server?

This server wraps the @google/genai SDK, exposing Google Gemini model capabilities as standard MCP tools. It allows other LLMs (like Cline) or MCP-compatible systems to leverage Gemini’s text generation, function calling, chat, file handling, and caching features.

How to use MCP Gemini Server?

Install via Smithery (npx -y @smithery/cli install @bsmi021/mcp-gemini-server) or manually (clone, npm install, npm run build). Configure your MCP client’s settings with the server’s path and required environment variables (GOOGLE_GEMINI_API_KEY, optionally GOOGLE_GEMINI_MODEL). Restart the client after configuration.

Key features of MCP Gemini Server

Standard and streaming text generation (gemini_generateContent, gemini_generateContentStream)
Function calling that lets Gemini request client-defined functions
Stateful chat sessions with history management
File upload, list, retrieve, and delete operations
Cache content creation, listing, retrieval, update, and deletion

Use cases of MCP Gemini Server

Integrate Gemini text generation into MCP-compatible assistants (e.g., Cline)
Enable function calling workflows where Gemini invokes external tools
Build conversational agents that maintain context across multiple turns
Upload and manage files (images, documents) for multimodal prompts
Optimize repeated prompt patterns with server-side content caching

FAQ from MCP Gemini Server

What runtime is required?

Node.js version 18 or later.

Where do I get an API key?

An API key from Google AI Studio (https://aistudio.google.com/app/apikey).

Can I use Vertex AI authentication?

No. The server only supports Google AI Studio API keys; file handling and caching features are not compatible with Vertex AI credentials.

How do I set a default Gemini model?

Set the GOOGLE_GEMINI_MODEL environment variable (e.g., gemini-1.5-flash). If not set, the modelName parameter becomes required on applicable tool calls.

What error types does the server return?

Errors are returned as McpError objects with an error code (InvalidParams, InternalError, etc.), a message, and optional details for troubleshooting (e.g., safety block reasons).

Frequently asked questions

What runtime is required?

Node.js version 18 or later.

Where do I get an API key?

An API key from Google AI Studio ([https://aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey)).

Can I use Vertex AI authentication?

No. The server only supports Google AI Studio API keys; file handling and caching features are not compatible with Vertex AI credentials.

How do I set a default Gemini model?

Set the `GOOGLE_GEMINI_MODEL` environment variable (e.g., `gemini-1.5-flash`). If not set, the `modelName` parameter becomes required on applicable tool calls.

What error types does the server return?

Errors are returned as `McpError` objects with an error code (`InvalidParams`, `InternalError`, etc.), a message, and optional details for troubleshooting (e.g., safety block reasons).

Comments

Basic information

More AI & Agents MCP servers

Hass-MCP

voska

Control and query Home Assistant from Claude and other LLMs — a Model Context Protocol (MCP) server.

307

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416

Sequential Thinking Multi-Agent System (MAS)

FradSer

An advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.

306

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K

1Panel

1Panel-dev

🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.

36.1K