Gemini MCP Server

Access Google's Gemini AI through the gemini-cli command-line tool.

GitHub

Gemini MCP Server

A Model Context Protocol (MCP) server that provides AI-powered internet search capabilities through the gemini-cli tool.

Overview

This MCP server allows Claude and other AI assistants to perform real-time internet searches by interfacing with the gemini-cli command-line tool. It provides a single query tool that can search for current information and provide AI-powered analysis.

Features

  • Real-time Search: Query current internet data through AI-powered search
  • MCP Protocol: Implements the Model Context Protocol for seamless integration
  • HTTP Streaming: Uses HTTP streaming transport for efficient communication
  • TypeScript: Fully typed with TypeScript for reliability
  • Graceful Shutdown: Handles SIGINT/SIGTERM signals for clean exits

Prerequisites

  • Node.js 18+
  • gemini-cli installed and configured on your system
  • TypeScript (for development)

Installation

  1. Clone the repository:
git clone <repository-url>
cd gemini-mcp
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

Usage

Development Mode

npm run dev

Production Mode

npm start

The server will start on port 13001 by default, or you can set a custom port:

PORT=8080 npm start

Configuration

Environment Variables

  • PORT: Server port (default: 13001)

MCP Tool

The server provides one tool:

query

  • Description: Send a query to an AI agent that can search real-time internet data
  • Parameters:
    • text (string): The search query or question to send to the AI agent
  • Returns: AI-generated response with current information

Integration

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "gemini-search": {
      "command": "node",
      "args": ["path/to/gemini-mcp/dist/index.js"],
      "env": {
        "PORT": "13001"
      }
    }
  }
}

With Other MCP Clients

Connect to the HTTP streaming endpoint:

http://localhost:13001

Development

Scripts

  • npm run build - Compile TypeScript to JavaScript
  • npm run start - Run the compiled server
  • npm run dev - Run in development mode with ts-node

Project Structure

src/
├── index.ts          # Main server implementation
├── package.json      # Project configuration
└── dist/            # Compiled JavaScript (after build)

Dependencies

  • fastmcp: MCP server framework
  • zod: Schema validation
  • child_process: Node.js built-in for spawning processes

License

MIT

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

Related Servers