Claude-to-Gemini MCP Server

Claude Code에서 Google Gemini를 MCP(Model Context Protocol) 서버로 사용하는 Agent-to-Agent 통합 프로젝트

🎯 프로젝트 목적

• Claude Code: 메인 AI (일반 코딩, 디버깅, 파일 생성/수정)

• Gemini: 서브 AI (대규모 컨텍스트 분석, 코드베이스 리뷰, 이미지 생성)

✨ 주요 기능

1. ask_gemini - 텍스트/코드 생성

• 용도: 일반 Gemini 호출, 큰 컨텍스트 분석

• 모델 선택:

  • flash (기본): Gemini 2.5 Flash - 무료, 빠름

  • pro: Gemini 3.1 Pro - 최신 모델 (2026.02 출시), 최고 성능

• 컨텍스트: 최대 1M 토큰

2. gemini_analyze_codebase - 코드베이스 분석

• 용도: 전체 코드베이스 전문 분석

• 분석 타입:

  • architecture: 아키텍처 패턴 분석

  • duplications: 중복 코드 탐지

  • security: 보안 취약점 검사

  • performance: 성능 최적화 기회

  • general: 종합 분석

3. generate_image_gemini - 이미지 생성 (Nano Banana 🍌)

• 용도: AI 이미지 생성 (Gemini 2.5 Flash Image)

• 특징:

  • 맥락 이해 및 대화형 편집

  • 이미지 편집 (요소 추가/제거)

  • 다중 이미지 합성

  • 무료 티어 제공 (토큰 기반)

• 파라미터:

  • prompt: 이미지 설명 (영문, 최대 480 토큰)

  • numberOfImages: 생성 개수 (1-4, 기본값: 1)

4. generate_image_imagen - 이미지 생성 (Imagen 3)

• 용도: 최고 품질 AI 이미지 생성

• 특징:

  • 포토리얼리스틱 품질

  • 고해상도 출력

  • 선명한 텍스트 렌더링

  • SynthID 워터마크 자동 포함

• 가격: $0.03/이미지

• 파라미터:

  • prompt: 이미지 설명 (영문, 최대 480 토큰)

  • numberOfImages: 생성 개수 (1-4, 기본값: 1)

🛠 기술 스택

• Runtime: Node.js 18+

• MCP SDK: @modelcontextprotocol/sdk

• AI API: Google Gemini API (@google/generative-ai)

• IDE: Claude Code (CLI + VSCode 확장)

📦 설치 방법

1. 사전 준비

• Node.js 18 이상 설치

• Claude Pro/Max 플랜 구독

• Google Gemini API 키 발급 (ai.google.dev)

2. 프로젝트 클론

git clone https://github.com/YOUR_USERNAME/claude-to-gemini.git
cd claude-to-gemini

3. 의존성 설치

npm install

4. MCP 서버 등록

claude mcp add gemini \
  --env GEMINI_API_KEY=YOUR_API_KEY_HERE \
  -- node /ABSOLUTE_PATH/claude-to-gemini/index.js

주의:

• YOUR_API_KEY_HERE를 실제 Gemini API 키로 교체

• /ABSOLUTE_PATH/를 실제 프로젝트 경로로 교체 (예: /Users/username/projects/claude-to-gemini/index.js)

5. 확인

claude mcp list

출력 예시:

gemini - node /Users/username/projects/claude-to-gemini/index.js

🚀 사용 방법

Claude Code 시작

claude

기본 사용 (Flash 모델, 무료)

ask_gemini 도구를 사용해서 "이 프로젝트 전체 구조를 분석해줘" 물어봐줘

Pro 모델 사용 (유료, 고성능)

ask_gemini 도구를 사용해서 model을 "pro"로 설정하고 "복잡한 아키텍처 설계해줘" 물어봐줘

코드베이스 분석

gemini_analyze_codebase 도구로 보안 취약점을 찾아줘

이미지 생성 (무료 - Nano Banana)

generate_image_gemini 도구로 "A futuristic robot coding in a cyberpunk city" 이미지 생성해줘

이미지 생성 (고품질 - Imagen 3)

generate_image_imagen 도구로 numberOfImages를 4로 설정하고
"Professional headshot of a software engineer" 이미지 4개 생성해줘

💡 사용 시나리오

시나리오 1: 새 프로젝트 아키텍처 설계

ask_gemini 도구로 React + Express + PostgreSQL
전자상거래 앱의 전체 아키텍처를 설계해줘

시나리오 2: 레거시 코드 분석

gemini_analyze_codebase 도구로
focus를 'duplications'로 설정해서 중복 코드를 찾아줘

시나리오 3: 대규모 리팩토링

ask_gemini 도구로 이 프로젝트 전체를 읽고
모던한 아키텍처로 마이그레이션 계획을 세워줘

📚 실전 가이드

실무에서 어떻게 활용하나요?

더 자세한 실전 활용법은 📖 실전 활용 가이드 (USECASES.md)를 참고하세요!

주요 내용:

• 🔍 부사수 코드 리뷰 (매일 아침 루틴)

• 🏗️ 대규모 리팩토링 (1200줄 마이그레이션)

• 🚀 프로젝트 온보딩 (1시간 내 핵심 파악)

• 🎨 아키텍처 설계 (Monorepo 구조)

• 💡 팁과 트릭 (비용 최적화, 모델 선택)

📊 모델 비교

텍스트/코드 생성 모델

이미지 생성 모델

⚠️ 보안 주의사항

API 키 보호

절대 금지:

• ❌ GitHub에 API 키 업로드

• ❌ 코드에 API 키 하드코딩

• ❌ 공개 장소에 API 키 공유

권장 사항:

• ✅ 환경변수로만 관리

• ✅ .gitignore에 .claude.json 포함

• ✅ API 키 유출 시 즉시 재발급

.gitignore 필수 내용

node_modules/
.claude.json
.env
*.key

🤝 기여 방법

1. Fork the Project

2. Create your Feature Branch (git checkout -b feature/AmazingFeature)

3. Commit your Changes (git commit -m 'Add some AmazingFeature')

4. Push to the Branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

📝 라이선스

MIT License - 자세한 내용은 LICENSE 파일 참조

🔗 참고 자료

• MCP 공식 문서

• Gemini API 문서

• Claude Code 문서

📧 문의

프로젝트 관련 문의: GitHub Issues

Made with ❤️ by [Your Name]