SG

sophomoresty/gemini-search-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

188 stars 33 forks 품질 70 트렌드 21

sophomoresty/gemini-search-mcp는 [[T0]에서 임보온 MCP 서버 후보입니다.

개요

sophomoresty/gemini-search-mcp는 [[T0]에서 임보온 MCP 서버 후보입니다.

개요(AI 번역)

Google AI 모드(Gemini)가 제공하는 웹 검색용 MCP 서버. 무료, 무제한, API 키 없음.

이게 뭐야

MCP 서버는 모든 AI 에이전트(클로드, 커서, 윈드서프 등)가 구글의 AI 모드(구글 검색의 ‘AI 모드’ 탭에 있는 동일한 제미니 기반 검색)를 사용해 실시간으로 웹을 검색할 수 있게 합니다.

구글의 검색 인덱스를 기반으로 한 Grok MCP / Tavily / SerpAPI의 무료 무제한 대안이라고 생각하세요.

특징

  • 무료: API 키, 구독, 할당량 없음
  • 무제한: 분당 60+ 요청, 속도 제한 없음
  • 구글 품질: Gemini + Google 검색 (실제 웹 결과에 기반함) 제공
  • MCP 원어: Claude Desktop, Claude Code, 커서, Windsurf, Cline 호환
  • 비MCP 클라이언트를 위해 OpenAI API도 제공합니다: /v1/chat/completions
  • 빠름: ~1.5초 평균 반응 시간

퀵 스타트

MCP 서버 (AI 에이전트용)

OpenAI 호환 API

MCP 통합

클로드 코드

클로드 데스크탑

claude_desktop_config.json에 추가:

커서 / 윈드서핑

같은 패턴입니다 — Stdio MCP 서버로 gemini-search-mcp를 가리킵니다.

MCP 도구

도구 설명

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

gemini-search-mcp

MCP server for web search powered by Google AI Mode (Gemini). Free, unlimited, no API key.

What is this

An MCP server that gives any AI agent (Claude, Cursor, Windsurf, etc.) the ability to search the web in real-time using Google’s AI Mode — the same Gemini-powered search that lives in the “AI Mode” tab on Google Search.

Think of it as a free, unlimited alternative to Grok MCP / Tavily / SerpAPI, backed by Google’s search index.

Features

  • Free: No API key, no subscription, no quota
  • Unlimited: 60+ requests/min with zero rate limiting
  • Google quality: Powered by Gemini + Google Search (grounded in real web results)
  • MCP native: Works with Claude Desktop, Claude Code, Cursor, Windsurf, Cline
  • Also ships OpenAI API: /v1/chat/completions for non-MCP clients
  • Fast: ~1.5s average response time

Quick Start

pip install -e .

# Optional: install the undetected-chromedriver backend for CAPTCHA probes.
pip install -e '.[undetected]'

MCP Server (for AI agents)

gemini-search-mcp

OpenAI-compatible API

gemini-search --port 8080

MCP Integration

Claude Code

claude mcp add gemini-search -- gemini-search-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-search": {
      "command": "gemini-search-mcp",
      "args": [],
      "env": {
        "CDP_URL": "http://127.0.0.1:9222"
      }
    }
  }
}

Cursor / Windsurf

Same pattern — point to gemini-search-mcp as an stdio MCP server.

MCP Tools

Tool Description
web_search(query) Search the web and get a synthesized answer grounded in real-time results
ask(prompt) General question — AI Mode auto-decides whether to search the web

Examples

web_search("latest AI regulation news 2026")
→ "The EU AI Act enforcement began on June 1, 2026, requiring..."

web_search("Bitcoin price today")
→ "As of June 30, 2026, Bitcoin is trading at $59,687 USD..."

ask("what is 1847 * 293")
→ "541171"

OpenAI API Usage

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-search","messages":[{"role":"user","content":"What happened in the news today?"}]}'
Field Value
Base URL http://localhost:8080/v1
API Key anything
Model gemini-search

Environment Variables

Variable Default Description
CDP_URL (none) Chrome DevTools URL. If set, connects to existing Chrome instead of launching one
BROWSER_CHANNEL chrome Browser to use: chrome, msedge, chromium
HEADLESS 1 Set to 0 to show browser window
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "gemini-search": { "command": "gemini-search-mcp", "args": [], "env": { "CDP_URL": "http://127.0.0.1:9222" } } } }