Skip to main content
Glama

gemini-mcp

npm MCP Registry Node.js License: MIT

Google Gemini를 Claude Code(또는 모든 MCP 클라이언트)용 도구로 노출하는 경량 MCP 서버입니다.

Gemini를 보조 의견, 대규모 컨텍스트 분석, 코드 리뷰, 또는 다른 모델의 관점이 도움이 되는 모든 작업에 사용하세요.

도구

도구

설명

gemini_ask

Gemini에 질문하거나 작업을 지시합니다

gemini_analyze

특정 지시사항과 함께 코드/텍스트를 분석용으로 보냅니다

gemini_chat

전체 기록이 포함된 다중 턴 대화

gemini_models

사용 가능한 Gemini 모델 목록을 표시합니다

Related MCP server: Gemini Bridge

빠른 시작

1. API 키 받기

Google AI Studio에서 무료 API 키를 만드세요.

2. 설치

옵션 A — 클론(Claude Code 권장)

git clone https://github.com/PavelGuzenfeld/gemini-mcp.git ~/.claude/mcp-servers/gemini
cd ~/.claude/mcp-servers/gemini
npm install

옵션 B — npx(설치 불필요)

npx claude-gemini-mcp

3. Claude Code에 등록

~/.claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/home/you/.claude/mcp-servers/gemini/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

또는 npx로:

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "claude-gemini-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

사용 예시

질문하기

> Use gemini_ask to explain the difference between std::expected and std::optional

Gemini says: std::optional<T> represents a value that may or may not be present...
std::expected<T, E> additionally carries an error value when the expected value is absent...

코드 분석

> Use gemini_analyze to review this function for performance issues:
  instruction: "Find performance bottlenecks"
  content: <your code here>

Gemini says: Line 12 allocates inside the loop — move the vector outside...

다중 턴 대화

> Use gemini_chat with messages:
  [{"role": "user", "content": "Design a REST API for a task manager"},
   {"role": "model", "content": "Here's a RESTful design..."},
   {"role": "user", "content": "Now add authentication"}]

Gemini says: Building on the previous design, add JWT-based auth...

호출별 모델 재정의

> Use gemini_ask with model: "gemini-2.5-flash" to quickly summarize this error log

환경 변수

변수

기본값

설명

GEMINI_API_KEY

(필수)

Google AI Studio API 키

GEMINI_MODEL

gemini-2.5-pro

모든 도구의 기본 모델

모델

모델

최적 용도

gemini-2.5-pro

최고 품질, 대규모 컨텍스트(1M 토큰)

gemini-2.5-flash

빠르며 대부분의 작업에 적합

gemini-2.0-flash

가장 빠르며, 단순한 작업에 적합

모든 도구는 선택적 model 매개변수를 사용하여 호출별 기본값을 재정의할 수 있습니다.

기능

  • 속도 제한(429) 및 서버 오류(5xx) 발생 시 지수 백오프 재시도

  • MCP 클라이언트에 오류를 원활하게 보고(충돌 없음)

  • 호출별 모델 재정의

  • API 키 외에 추가 구성 불필요

문제 해결

문제

해결 방법

GEMINI_API_KEY is not set

settings.jsonenv 블록에 키를 추가하세요

429 Too Many Requests

내장 재시도가 처리합니다 — 몇 초 기다리세요

Model not found

gemini_models를 실행하여 유효한 모델 이름을 확인하세요

Claude Code에 도구가 표시되지 않음

~/.claude/settings.json 구문을 확인하고 Claude Code를 다시 시작하세요

ECONNREFUSED

네트워크/방화벽을 확인하세요 — 서버가 generativelanguage.googleapis.com을 호출합니다

개발

git clone https://github.com/PavelGuzenfeld/gemini-mcp.git
cd gemini-mcp
npm install
npm test          # Run smoke tests
node index.js     # Start the MCP server locally

라이선스

MIT

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Augments MCP Server - A comprehensive framework documentation provider for Claude Code

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • MCP server for AI dialogue using various LLM models via AceDataCloud

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/PavelGuzenfeld/gemini-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server