Skip to main content
Glama
deenesjakoruzh
PavelGuzenfeld

gemini-mcp

by PavelGuzenfeld
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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.json의 env 블록에 키를 추가하세요

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

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers