Gemini MCP Server

Gemini MCP Server

Enables Claude Code to use Google Gemini AI capabilities for analyzing PDFs and images, generating and translating text, and reviewing code. Supports both CLI and API backends with different quota limits.

Category
Visit Server

README

gemini-mcp

Claude Code에서 Google Gemini AI 기능을 사용하기 위한 MCP 서버

기능

도구 설명
analyze_pdf PDF 문서 분석 (URL/로컬 파일, 표/차트/이미지 포함)
analyze_image 이미지 분석 (스크린샷, 차트, 다이어그램)
generate_text 텍스트 생성/요약/번역
analyze_code 코드 리뷰/설명/개선
gemini_chat 세션 기반 멀티턴 대화 (CLI 전용)
gemini_sessions 대화 세션 목록 조회 (CLI 전용)

백엔드 선택

백엔드 쿼터 설명
cli (기본) 60 RPM, 1000 RPD Gemini CLI 사용, Google One 지원
api 5 RPM, 20 RPD 직접 API 호출

Gemini CLI가 설치되어 있으면 자동으로 CLI 백엔드를 사용합니다.

설치

1. Gemini CLI 설치 (권장)

npm install -g @google/gemini-cli
gemini  # 첫 실행 시 Google 계정 로그인

2. Claude Code MCP 설정

~/.mcp.json:

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/path/to/gemini-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

API 키는 CLI 사용 시 선택사항입니다.

API 키 발급 (API 백엔드용)

  1. Google AI Studio에서 API 키 발급
  2. ~/.mcp.json에 설정

사용 예시

PDF 분석

analyze_pdf(
  source: "https://example.com/report.pdf",
  prompt: "이 보고서의 핵심 내용을 요약해주세요"
)

이미지 분석

analyze_image(
  source: "~/screenshots/error.png",
  prompt: "이 에러 메시지를 분석해주세요"
)

텍스트 생성

generate_text(
  prompt: "다음을 영어로 번역해주세요",
  context: "안녕하세요, 반갑습니다."
)

코드 분석

analyze_code(
  code: "function add(a, b) { return a + b; }",
  language: "javascript",
  task: "review"
)

세션 기반 대화 (CLI 전용)

# 새 대화 시작
gemini_chat(message: "이 코드 리뷰해줘")

# 이전 대화 이어가기
gemini_chat(message: "더 자세히 설명해줘", resume: "latest")

# 특정 세션 재개
gemini_chat(message: "계속해서...", resume: 1)

# 세션 목록 조회
gemini_sessions()

백엔드/모델 직접 지정

generate_text(
  prompt: "Hello",
  provider: "api",
  model: "pro"
)

모델 선택

파라미터 모델 설명
flash (기본) gemini-3-flash-preview 최신, 가장 빠름
pro gemini-3-pro-preview 최신, 복잡한 추론
flash-2.5 gemini-2.5-flash 레거시
pro-2.5 gemini-2.5-pro 레거시
flash-lite gemini-2.5-flash-lite 저비용/대량 처리

로깅

모든 요청/응답이 로그로 기록됩니다.

환경변수 기본값 설명
GEMINI_LOG_LEVEL info 로그 레벨 (debug, info, warn, error, none)
GEMINI_LOG_DIR ~/.gemini-mcp/logs 로그 디렉토리

로그 파일:

  • ~/.gemini-mcp/logs/gemini-mcp-YYYY-MM-DD.log - 전체 로그
  • ~/.gemini-mcp/logs/gemini-mcp-YYYY-MM-DD-error.log - 에러 로그

쿼터 비교

백엔드 RPM RPD 기본 모델
API (Free) 5 20 gemini-3-flash-preview
CLI (Free) 60 1,000 gemini-3-flash-preview
CLI (Google One) 더 높음 더 높음 gemini-3-flash-preview

라이선스

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured