MCP Gemini Google Search

日本語

A Model Context Protocol (MCP) server that provides Google Search functionality using Gemini's built-in Grounding with Google Search feature.

This project is inspired by the GoogleSearch tool from gemini-cli.

Features

• Uses Gemini's built-in Grounding with Google Search feature
• Provides real-time web search results with source citations
• Compliant with MCP standard protocol
• Supports stdio transport
• Supports both Google AI Studio and Vertex AI

Requirements

• Node.js 18 or later
• Google AI Studio API key (Get one here) or Google Cloud Project with Vertex AI enabled

Installation

npm install -g mcp-gemini-google-search

Usage

Environment Variables

# For Google AI Studio (default)
export GEMINI_API_KEY="your-api-key-here"
export GEMINI_MODEL="gemini-2.5-flash"  # Optional (default: gemini-2.5-flash)

# For Vertex AI
export GEMINI_PROVIDER="vertex"
export VERTEX_PROJECT_ID="your-gcp-project-id"
export VERTEX_LOCATION="us-central1"  # Optional (default: us-central1)
export GEMINI_MODEL="gemini-2.5-flash"  # Optional (default: gemini-2.5-flash)

Claude Code Configuration

You can set up this MCP server in Claude Code using the CLI:

For Google AI Studio

# Add to user scope (available across all projects)
claude mcp add gemini-google-search \
  -s user \
  -e GEMINI_API_KEY="your-api-key-here" \
  -e GEMINI_MODEL="gemini-2.5-flash" \
  -- npx mcp-gemini-google-search

# Or add to project scope to share with your team
claude mcp add gemini-google-search \
  -s project \
  -e GEMINI_API_KEY="your-api-key-here" \
  -e GEMINI_MODEL="gemini-2.5-flash" \
  -- npx mcp-gemini-google-search

For Vertex AI

# Add to user scope (available across all projects)
claude mcp add gemini-google-search \
  -s user \
  -e GEMINI_PROVIDER="vertex" \
  -e VERTEX_PROJECT_ID="your-gcp-project-id" \
  -e VERTEX_LOCATION="us-central1" \
  -e GEMINI_MODEL="gemini-2.5-flash" \
  -- npx mcp-gemini-google-search

# Or add to project scope to share with your team
claude mcp add gemini-google-search \
  -s project \
  -e GEMINI_PROVIDER="vertex" \
  -e VERTEX_PROJECT_ID="your-gcp-project-id" \
  -e VERTEX_LOCATION="us-central1" \
  -e GEMINI_MODEL="gemini-2.5-flash" \
  -- npx mcp-gemini-google-search

Windows Users

On Windows, wrap the npx command with cmd /c:

claude mcp add gemini-google-search \
  -e GEMINI_API_KEY="your-api-key-here" \
  -- cmd /c npx mcp-gemini-google-search

Available Tools

google_search

Search Google for information.

Parameters:

• query (string, required): Search query

Example:

latest TypeScript features

It appears you're asking about the latest features in TypeScript. Here's a summary of recent updates and key features, based on the provided search results:

**Key Features in Recent TypeScript Updates:**

*   **Satisfies Operator:** This operator lets you specify that a value conforms to a specific type without fully enforcing it.[1,2]
*   **Const Type Parameters:** Using `const` with type parameters provides more precision with function generics, helping specify literal types and prevent unwanted transformations.[2] This ensures arrays are treated as immutable, maintaining their literal types.[2]
*   **Improved Enum Types:** Enums are more robust, especially `const enum`, which optimizes enums by inlining their values at compile time.[2] From version 5.0, all enums are treated as a type union, even with calculated values.[1]
*   **Template Literal Types:** Template literal types are more expressive, allowing y

... [View full README on GitHub](https://github.com/yukukotani/mcp-gemini-google-search#readme)