@mcn1ne/gemini-mcp-node

Gemini 토론 MCP 서버 (Node.js / stdio). Claude Code에 등록해 사용한다.

노출되는 도구 3개:

• ask_gemini(prompt, conversation_id="default", system=null)
• reset_conversation(conversation_id="default")
• list_conversations()

대화 컨텍스트는 인메모리(프로세스 종료 시 휘발).

한 줄 설치 (가장 간단)

요구사항: Node.js 20+, Vertex AI 서비스 계정 JSON 키 파일

1) 환경 파일 생성

cmd 또는 PowerShell에서:

npx -y @mcn1ne/gemini-mcp-node@latest --init

%USERPROFILE%\.gemini-mcp\.env (Unix: ~/.gemini-mcp/.env) 에 템플릿이 만들어진다.

2) .env 편집

notepad "%USERPROFILE%\.gemini-mcp\.env"

열어서 4개 값을 채운다:

VERTEXAI_CREDENTIALS_PATH=C:\Users\<본인>\secrets\igs-vertex-key.json
VERTEXAI_PROJECT_ID=<프로젝트 ID>
VERTEXAI_LOCATION=global
VERTEXAI_MODEL=gemini-3.5-flash

서비스 계정 JSON 키 파일은 안전한 위치에 두고 절대경로만 적는다.

3) Claude Code에 등록

claude mcp add gemini-debate -- npx -y @mcn1ne/gemini-mcp-node@latest

Claude Code 완전 재시작 후 /mcp에서:

gemini-debate    ✓ connected
  Tools:
    - ask_gemini
    - reset_conversation
    - list_conversations

가 보이면 정상.

전역 설치 방식 (npx가 안 되는 환경에서)

Git Bash 등 일부 환경에서 npx가 스코프드 패키지의 bin을 못 찾으면 전역 설치로 우회:

npm install -g @mcn1ne/gemini-mcp-node
gemini-mcp-node --init
notepad "%USERPROFILE%\.gemini-mcp\.env"
claude mcp add gemini-debate -- gemini-mcp-node

전역 설치 후엔 gemini-mcp-node 단일 명령으로 실행 가능.

동작 확인 (선택)

Gemini 호출 자체가 되는지만 빠르게 보고 싶다면 (전역 설치한 경우):

npm install -g @mcn1ne/gemini-mcp-node
node "%APPDATA%\npm\node_modules\@mcn1ne\gemini-mcp-node\smoke_test.js"

트러블슈팅

| 증상 | 원인 / 해결 | |---|---| | .env 가 없습니다 | --init을 먼저 실행 | | VERTEXAI_CREDENTIALS_PATH not found | .env 안의 키 파일 경로 오타 또는 파일 없음 | | PERMISSION_DENIED | 서비스 계정에 Vertex AI User 권한 없음 | | NOT_FOUND | 모델명 또는 리전 오류 (global / gemini-3.5-flash 확인) | | 'gemini-mcp-node'은(는) 내부 또는 외부 명령... (Git Bash) | 전역 설치 방식 사용 (npm install -g @mcn1ne/gemini-mcp-node) | | /mcp에 ✗ Failed to connect | 위 명령을 터미널에서 직접 실행해 stderr 메시지 확인 |

버전 고정

@latest 없이 특정 버전으로 핀하면 회귀 방지:

claude mcp add gemini-debate -- npx -y @mcn1ne/[email protected]

라이선스

MIT