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-cliinstalled and configured on your systemTypeScript (for development)
Installation
Clone the repository:
Install dependencies:
Build the project:
Usage
Development Mode
Production Mode
The server will start on port 13001 by default, or you can set a custom port:
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:
With Other MCP Clients
Connect to the HTTP streaming endpoint:
Development
Scripts
npm run build- Compile TypeScript to JavaScriptnpm run start- Run the compiled servernpm run dev- Run in development mode with ts-node
Project Structure
Dependencies
fastmcp: MCP server framework
zod: Schema validation
child_process: Node.js built-in for spawning processes
License
MIT
Contributing
Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request