
sophomoresty/gemini-search-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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/completionsfor 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 |
설치
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"
}
}
}
}