Gemini MCP Server
Provides tools for analyzing PDFs and images, generating and translating text, and reviewing code using Google Gemini AI models (flash and pro variants) with support for both CLI and API backends.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Gemini MCP Server analyze this PDF and summarize the key findings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gemini-mcp
Claude Code에서 Google Gemini AI 기능을 사용하기 위한 MCP 서버
기능
도구 | 설명 |
| PDF 문서 분석 (URL/로컬 파일) |
| 이미지 분석 (스크린샷, 차트, 다이어그램) |
| 텍스트 생성/요약/번역 |
| 코드 리뷰/설명/개선 |
백엔드 선택
백엔드 | 쿼터 | 설명 |
| 60 RPM, 1000 RPD | Gemini CLI 사용, Google One 지원 |
| 5 RPM, 20 RPD | 직접 API 호출 |
Gemini CLI가 설치되어 있으면 자동으로 CLI 백엔드를 사용합니다.
설치
1. Gemini CLI 설치 (권장)
npm install -g @anthropic-ai/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 백엔드용)
Google AI Studio에서 API 키 발급
~/.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"
)백엔드 직접 지정
generate_text(
prompt: "Hello",
provider: "api" # 또는 "cli"
)모델 선택
모델 | 설명 |
| 빠른 응답 |
| 심층 분석 |
쿼터 비교
백엔드 | RPM | RPD | 모델 |
API (Free) | 5 | 20 | gemini-2.5-flash |
CLI (Free) | 60 | 1,000 | gemini-2.5-pro |
CLI (Google One) | 더 높음 | 더 높음 | gemini-2.5-pro |
라이선스
MIT
Available Tools
4 toolsanalyze_codeB
코드를 분석합니다. 리뷰(review), 설명(explain), 개선(improve) 중 선택할 수 있습니다.
Inputs: code (required), language, task, prompt, +2 more.
analyze_imageC
이미지를 분석합니다. 스크린샷, 차트, 다이어그램, 사진 등을 지원합니다. (JPEG, PNG, GIF, WebP)
Inputs: source (required), prompt (required), model, provider.
analyze_pdfC
PDF 문서를 분석합니다. URL 또는 로컬 파일 경로를 지원합니다.
Inputs: source (required), prompt (required), model, provider.
generate_textB
텍스트를 생성합니다. 요약, 번역, 창작 등에 활용할 수 있습니다.
Inputs: prompt (required), context, model, maxTokens, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose based on the input type: analyze_code for code, analyze_image for images, analyze_pdf for PDFs, and generate_text for text generation. There is no overlap in functionality, making it easy for an agent to select the correct tool without confusion.
All tool names follow a consistent verb_noun pattern with 'analyze_' or 'generate_' prefixes, using snake_case uniformly. This predictable naming scheme enhances readability and usability across the tool set.
With 4 tools, the server is well-scoped for a Gemini MCP server focused on analysis and generation tasks, though it might feel slightly thin if more specialized operations are needed. The count is reasonable and each tool earns its place.
The tool set covers core analysis and generation functions for code, images, PDFs, and text, with no obvious dead ends. Minor gaps might exist, such as lack of update or delete operations, but agents can work around these for the stated purpose.
Related MCP Connectors
Generate images and video from Claude with one API key.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Images, video, voiceovers, music and editing inside Claude and ChatGPT, priced in credits.
Generate and edit images and create short videos inside Claude. Prepaid credits, no subscription.