Claude Gemini Bridge

Claude Code için Vertex AI üzerinden Gemini 3 modellerine erişim sağlayan MCP sunucusu.

Özellikler

• Text Generation: Context ve system instruction desteği ile metin üretimi

• Multi-turn Chat: Oturum yönetimi ile çok turlu konuşmalar

• Image Generation: Gemini 3 Pro Image ve Imagen 4 aileleri ile görsel üretimi

• Video Generation: Veo 3.1 ile yüksek kaliteli video üretimi (otomatik GCS bucket)

• Frontend Design: Gemini 3 Pro ile yüksek kaliteli TailwindCSS/HTML bileşen tasarımı

  • 49 component tipi (atoms, molecules, organisms)

  • 10 page template (landing, dashboard, auth, vb.)

  • 14 tema (modern-minimal, cyberpunk, glassmorphism, vb.)

  • Proje bağlamı desteği (projenin ruhunu Gemini'ye aktarma)

  • İterasyon desteği (mevcut tasarımları revize etme)

  • Türkçe içerik üretimi

• Streaming: Hızlı ilk yanıt için streaming desteği

• OAuth Authentication: ADC ve gcloud CLI ile otomatik kimlik doğrulama

Gereksinimler

• Python 3.10+

• Google Cloud hesabı ve proje

• gcloud CLI kurulu ve yapılandırılmış

• uv package manager

Kurulum

1. gcloud Kimlik Doğrulama

# Giriş yapın
gcloud auth login

# Application Default Credentials ayarlayın
gcloud auth application-default login

# Proje ayarlayın
gcloud config set project YOUR_PROJECT_ID

2. Bağımlılıkları Yükleyin

cd /path/to/claude-gemini-bridge
uv sync

3. Environment Variables

export GOOGLE_CLOUD_PROJECT="your-project-id"
# NOT: Gemini 3 modelleri "global" location gerektirir (default)
export GOOGLE_CLOUD_LOCATION="global"  # Opsiyonel, default: global

4. Claude Code'a Ekleyin

~/.claude/.mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "gemini": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/claude-gemini-bridge", "gemini-mcp"],
      "env": {
        "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID",
        "GOOGLE_CLOUD_LOCATION": "global"
      }
    }
  }
}

Not: /path/to/claude-gemini-bridge kısmını projeyi klonladığınız gerçek dizin yolu ile değiştirin.

MCP Tools

ask_gemini

Gemini 3'e tek seferlik soru sorma.

Parametreler:

Örnek:

"Bu Python kodunu optimize et: [kod]. Context: Performans kritik."

chat_gemini

Gemini 3 ile çok turlu konuşma.

Parametreler:

generate_image

Gemini 3 Pro Image ile görsel üretimi (4096px yüksek kalite).

Parametreler:

generate_video

Veo 3.1 ile video üretimi. GCS bucket otomatik oluşturulur.

ÖNEMLİ: Video üretimi 1-10 dakika sürebilir.

Parametreler:

Örnek:

prompt="A golden retriever running through a sunlit meadow, slow motion, cinematic"
duration_seconds=8
resolution="1080p"

design_frontend

Gemini 3 Pro ile yüksek kaliteli frontend bileşen tasarımı.

Parametreler:

Bileşen Tipleri (49 adet):

• Atoms (13): button, input, badge, avatar, icon, dropdown, toggle, tooltip, slider, spinner, progress, chip, divider

• Molecules (18): card, form, modal, tabs, table, accordion, alert, breadcrumb, pagination, search_bar, stat_card, pricing_card, carousel, stepper, timeline, file_upload, rating, color_picker

• Organisms (18): navbar, hero, sidebar, footer, data_table, login_form, signup_form, contact_form, feature_section, testimonial_section, pricing_table, dashboard_header, kanban_board, calendar, chat_widget, notification_center, user_profile, settings_panel

Temalar (14 adet):

• modern-minimal - Temiz, profesyonel

• brutalist - Kalın, yüksek kontrastlı

• glassmorphism - Buzlu cam efekti

• neo-brutalism - Eğlenceli, canlı renkler

• soft-ui - Neumorfik, yumuşak derinlik

• corporate - Kurumsal, güvenilir

• gradient - Gradient-ağırlıklı modern tasarım

• cyberpunk - Neon renkler, koyu arka plan

• retro - 80'ler/90'lar ilham

• pastel - Yumuşak pastel tonlar

• dark_mode_first - Dark mode optimizasyonlu

• high_contrast - WCAG AAA erişilebilirlik

• nature - Toprak tonları, organik his

• startup - Tech startup estetiği

Örnek:

{
  "component_type": "pricing_card",
  "context": "SaaS fiyatlandırma sayfası için Pro tier kartı",
  "content_structure": "{\"tier\": \"Pro\", \"price\": \"$29/ay\", \"features\": [\"Sınırsız kullanıcı\", \"Öncelikli destek\"], \"cta\": \"Başla\"}",
  "theme": "modern-minimal",
  "dark_mode": true
}

Çıktı:

{
  "component_id": "pricing-card-pro",
  "atomic_level": "molecule",
  "html": "<div class=\"bg-white dark:bg-slate-800...\">...</div>",
  "tailwind_classes_used": ["rounded-xl", "shadow-lg", "..."],
  "accessibility_features": ["aria-label", "focus-visible"],
  "responsive_breakpoints": ["sm", "md", "lg"],
  "dark_mode_support": true,
  "micro_interactions": ["hover:shadow-xl", "transition-all"],
  "design_notes": "...",
  "model_used": "gemini-3-pro-preview"
}

design_page

Gemini 3 Pro ile tam sayfa template tasarımı.

Parametreler:

Template Tipleri (10 adet):

• landing_page - Marketing landing page (hero, features, testimonials, pricing, CTA, footer)

• dashboard - Admin dashboard (sidebar, header, stats, charts, tables)

• auth_page - Login/signup sayfası (form, social login, branding)

• pricing_page - Fiyatlandırma karşılaştırma (tiers, features, FAQ)

• blog_post - Blog makale layout (header, content, sidebar, comments)

• product_page - E-commerce ürün sayfası (gallery, details, reviews, related)

• portfolio - Portfolio/showcase (hero, projects, about, contact)

• documentation - Docs sayfa layout (sidebar nav, content, TOC)

• error_page - 404/500 hata sayfaları

• coming_soon - Coming soon/maintenance sayfası

refine_frontend

Mevcut bir tasarımı doğal dil ile revize etme.

Parametreler:

Örnek Kullanım:

# İlk tasarımı al
result = design_frontend(component_type="button", context="CTA butonu")

# Değişiklik iste
refined = refine_frontend(
    previous_html=result["html"],
    modifications="Buton rengini maviden yeşile çevir, köşeleri daha yuvarlak yap"
)

Örnek Modification İstekleri:

• "Buton rengini maviden yeşile çevir"

• "Header'ı daha kompakt yap"

• "Dark mode desteği ekle"

• "Mobil responsive sorunlarını düzelt"

• "Font boyutunu büyüt"

• "Hover efektini daha belirgin yap"

list_frontend_options

Kullanılabilir bileşen tiplerini, temaları ve template'leri listele.

list_models

Kullanılabilir modelleri listele.

clear_chat_session

Chat oturumunu temizle.

Kullanılabilir Modeller

Text Modelleri

• gemini-3-flash-preview - Pro-grade reasoning, Flash hızında (1M context)

• gemini-3-pro-preview - En güçlü reasoning, kompleks agentic workflows (1M context)

Image Modelleri

• gemini-3-pro-image-preview - Yüksek kalite görsel üretimi (4096px, legible text, character consistency)

• imagen-4.0-ultra-generate-001 - Ultra yüksek kalite ($0.06/görsel)

• imagen-4.0-generate-001 - Standart yüksek kalite ($0.04/görsel)

• imagen-4.0-fast-generate-001 - Hızlı üretim ($0.02/görsel)

Video Modelleri

• veo-3.1-generate-001 - Yüksek kalite, native audio (~$0.40/saniye)

• veo-3.1-fast-generate-001 - Hızlı üretim (~$0.15/saniye)

Thinking Level

Gemini 3 modelleri için reasoning derinliği:

• minimal - Hızlı, basit cevaplar

• low - Hafif düşünme

• medium - Dengeli yaklaşım (default)

• high - Derin reasoning, kompleks problemler

Sorun Giderme

"GOOGLE_CLOUD_PROJECT not set" hatası

export GOOGLE_CLOUD_PROJECT="your-project-id"

Authentication hatası

gcloud auth application-default login

Token süresi doldu

Token otomatik olarak yenilenir. Sorun devam ederse:

gcloud auth application-default print-access-token

Test

# Token kontrolü
gcloud auth application-default print-access-token

# MCP server'ı manuel çalıştırma
uv run gemini-mcp

Lisans

MIT