Claude Gemini Bridge

License: MIT Python 3.10+

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:

Parametre	Tip	Default	Açıklama
prompt	str	(zorunlu)	Soru veya görev
context	str	""	Arka plan bilgisi
system_instruction	str	""	Sistem talimatları
model	str	"gemini-3-flash-preview"	Kullanılacak model
temperature	float	0.7	Yaratıcılık (0-1)
max_tokens	int	65536	Maksimum yanıt uzunluğu
thinking_level	str	"medium"	Reasoning derinliği (minimal, low, medium, high)
stream	bool	true	Streaming kullanımı

Örnek:

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

chat_gemini

Gemini 3 ile çok turlu konuşma.

Parametreler:

Parametre	Tip	Default	Açıklama
message	str	(zorunlu)	Gönderilecek mesaj
chat_id	str	"default"	Oturum kimliği
model	str	"gemini-3-flash-preview"	Kullanılacak model
system_instruction	str	""	Yeni oturumlar için

generate_image

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

Parametreler:

Parametre	Tip	Default	Açıklama
prompt	str	(zorunlu)	Görsel açıklaması
model	str	"gemini-3-pro-image-preview"	Model
aspect_ratio	str	"1:1"	En boy oranı
output_format	str	"base64"	"base64", "file", "both"
output_dir	str	"./images"	Dosya çıktı dizini
number_of_images	int	1	Üretilecek görsel sayısı (1-4, Imagen 4)
output_resolution	str	"1K"	Çıktı çözünürlüğü (1K/2K, Imagen 4)

generate_video

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

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

Parametreler:

Parametre	Tip	Default	Açıklama
prompt	str	(zorunlu)	Video açıklaması
model	str	"veo-3.1-generate-001"	Kullanılacak model
output_gcs_uri	str	""	GCS URI (opsiyonel, otomatik oluşturulur)
duration_seconds	int	8	Video süresi (4, 6, 8 saniye)
aspect_ratio	str	"16:9"	En boy oranı (16:9, 9:16)
resolution	str	"720p"	Çözünürlük (720p, 1080p)
generate_audio	bool	true	Ses üretimi (diyalog, müzik, SFX)
number_of_videos	int	1	Video sayısı (1-4)

Ö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:

Parametre	Tip	Default	Açıklama
component_type	str	(zorunlu)	Bileşen tipi (button, card, navbar, hero, vb.)
context	str	""	Kullanım bağlamı
content_structure	str	"{}"	JSON formatında bileşen içeriği
theme	str	"modern-minimal"	Görsel tema
dark_mode	bool	true	Dark mode desteği
border_radius	str	""	Özel köşe yuvarlaklığı
responsive_breakpoints	str	"sm,md,lg"	Responsive breakpoints
accessibility_level	str	"AA"	WCAG seviyesi (AA/AAA)
micro_interactions	bool	true	Hover/focus animasyonları
max_width	str	""	Maksimum genişlik
project_context	str	""	Proje bağlamı (amaç, hedef kitle, ton, sektör)

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:

Parametre	Tip	Default	Açıklama
template_type	str	(zorunlu)	Template tipi
context	str	""	Kullanım bağlamı
content_structure	str	"{}"	JSON formatında sayfa içeriği
theme	str	"modern-minimal"	Görsel tema
dark_mode	bool	true	Dark mode desteği
project_context	str	""	Proje bağlamı

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:

Parametre	Tip	Default	Açıklama
previous_html	str	(zorunlu)	Önceki HTML tasarımı
modifications	str	(zorunlu)	İstenen değişiklikler (doğal dilde)
project_context	str	""	Proje bağlamı

Ö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