
Gemini MCP Server
โ 1from loming
Access Google's Gemini AI through the gemini-cli command-line tool.
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
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:13001Development
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
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
npm installBefore it works, you'll need: PORT
Prerequisites
- Node.js 18+
gemini-cliinstalled and configured on your system- TypeScript (for development)
Installation
- Clone the repository:
git clone <repository-url>
cd gemini-mcp- Install dependencies:
npm install- Build the project:
npm run buildUsage
Development Mode
npm run devProduction Mode
npm startThe server will start on port 13001 by default, or you can set a custom port:
PORT=8080 npm startConfiguration
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
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
License
MIT