MCP Rubber Duck

Birden fazla LLM'yi sorgulayan bir MCP (Model Context Protocol) sunucusu -- hem OpenAI-uyumlu HTTP API'leri hem de CLI kodlama aracılarını destekler. Tıpkı rubber duck debugging gibi, sorunlarınızı çeşitli yapay zeka "ordeklerine" açıklayın ve farklı perspektifler alın!

Özellikler

• Evrensel OpenAI Uyumluluğu -- Herhangi bir OpenAI-uyumlu API endpoint'i ile çalışır
• CLI Aracı Desteği -- CLI kodlama aracılarını (Claude Code, Codex, Gemini CLI, Grok, Aider) ordek olarak kullanın
• Birden Fazla Ordek -- Birden fazla LLM sağlayıcısını eş zamanlı olarak yapılandırın ve sorgulayın
• Konuşma Yönetimi -- Bağlam birden fazla mesajda korunur
• Duck Council -- Tüm yapılandırılmış ordeklarınızdan yanıtlar alın
• Fikir Birliği Oylaması -- Çok ordekli oylama, akıl yürütme ve güven puanları ile
• LLM-as-Judge -- Ordekklerinin birbirinin yanıtlarını değerlendir ve sıralanmasını sağlayın
• Yinelemeli İyileştirme -- İki ordek yanıtları işbirliği ile geliştirer
• Yapılandırılmış Tartışmalar -- Oxford, Sokratik ve karşıt tartışma formatları
• MCP Prompts -- Çok-LLM iş akışları için 8 yeniden kullanılabilir prompt şablonu
• Vision Input -- Resimleri promptların yanında vision-özellikli modellere gönderin (docs)
• Otomatik Failover -- Primary başarısız olursa diğer sağlayıcılara geri döner
• Sağlık İzleme -- Tüm sağlayıcılar için gerçek zamanlı sağlık kontrolleri
• Kullanım Takibi -- Sağlayıcı başına request'ler, tokenler ve tahmini maliyetleri takip edin
• MCP Bridge -- Ordekkeri genişletilmiş işlevsellik için diğer MCP sunucularına bağlayın (docs)
• Guardrails -- Rate limiting, token limitleri, pattern blocking ve PII redaksiyon ile taşınabilir güvenlik katmanı (docs)
• Granüler Güvenlik -- Sunucu başına onay kontrolleri ve oturum tabanlı onaylar
• İnteraktif UI'ler -- Karşılaştırma, oy, tartışma ve kullanım araçları için zengin HTML panelleri (MCP Apps aracılığıyla)
• Tool Açıklamaları -- Tool davranışı için MCP-uyumlu ipuçları (read-only, destructive, vb.)
• Yapılandırılmış Output -- Istemci tarafı doğrulama için yapılandırılmış JSON döndüren araçlarda outputSchema (Cursor, VS Code/Copilot)

Desteklenen Sağlayıcılar

HTTP Sağlayıcılar (OpenAI-uyumlu API)

OpenAI-uyumlu API endpoint'i olan herhangi bir sağlayıcı, şunlar dahil:

• OpenAI (GPT-5.1, o3, o4-mini)
• Google Gemini (Gemini 3, Gemini 2.5 Pro/Flash)
• Anthropic (OpenAI-uyumlu endpoint'ler aracılığıyla)
• Groq (Llama 4, Llama 3.3)
• Together AI (Llama 4, Qwen ve daha fazlası)
• Perplexity (Web araması ile Online modeller)
• Anyscale, Azure OpenAI, Ollama, LM Studio, Custom

CLI Sağlayıcılar (Kodlama Aracıları)

Yerel işlemler olarak çalışan komut satırı kodlama aracıları:

• Claude Code (claude) -- Codex (codex) -- Gemini CLI (gemini) -- Grok CLI (grok) -- Aider (aider) -- Custom

Tam kurulum ve yapılandırma için bkz. CLI Providers.

Hızlı Başlangıç

# Küresel olarak yükle
npm install -g mcp-rubber-duck

# Veya Claude Desktop yapılandırmasında npx'i doğrudan kullan
npx mcp-rubber-duck

Claude Desktop kullanıyor musunuz? Claude Desktop Yapılandırması'na atlayın. Cursor, VS Code, Windsurf veya başka bir araç kullanıyor musunuz? Kurulum Rehberi'ne bakın.

Kurulum

Ön Koşullar

• Node.js 20 veya üstü
• npm veya yarn
• HTTP sağlayıcısı için en az bir API anahtarı, veya yerel olarak yüklenmiş bir CLI kodlama aracısı

NPM'den Yükle

npm install -g mcp-rubber-duck

Kaynaktan Yükle

git clone https://github.com/nesquikm/mcp-rubber-duck.git
cd mcp-rubber-duck
npm install
npm run build
npm start

Yapılandırma

Bir .env dosyası veya config/config.json oluşturun. Ana ortam değişkenleri:

Değişken	Açıklama
OPENAI_API_KEY	OpenAI API anahtarı
GEMINI_API_KEY	Google Gemini API anahtarı
GROQ_API_KEY	Groq API anahtarı
DEFAULT_PROVIDER	Varsayılan sağlayıcı (örn. openai)
DEFAULT_TEMPERATURE	Varsayılan sıcaklık (örn. 0.7)
LOG_LEVEL	debug, info, warn, error
MCP_SERVER	MCP sunucu modu için true olarak ayarlayın
MCP_BRIDGE_ENABLED	MCP Bridge'i etkinleştir (ordekkeri dış MCP sunucularına erişir)
CUSTOM_{NAME}_*	Özel HTTP sağlayıcılar
CLI_{AGENT}_ENABLED	CLI aracılarını etkinleştir (CLAUDE, CODEX, GEMINI, GROK, AIDER)

Tam referans: Yapılandırma docs

İnteraktif UI'ler (MCP Apps)

Dört araç -- compare_ducks, duck_vote, duck_debate ve get_usage_stats -- MCP Apps aracılığıyla desteklenen MCP istemcilerinin içinde zengin etkileşimli HTML panelleri render edebilir. Bu MCP sunucusu destekleyen bir istemcide yapılandırıldıktan sonra, UI'ler otomatik olarak görünür -- ek kurulum gerekli değildir. MCP Apps desteği olmayan istemciler yine de aynı düz metin çıktısını alır (hiçbir işlevsellik kaybedilmez). Desteklenen istemcilerin güncel listesi için MCP Apps repo'ya bakın.

Ordekkeri Karşılaştır

Birden fazla model yanıtını yan yana karşılaştırın, gecikme göstergeleri, token sayıları, model rozetleri ve hata durumları ile.

Duck Vote

Birden fazla ordek'in seçenekleri oylamasını sağlayın, görsel oy talsı, bar grafikler, fikir birliği rozeti, kazanan kartı, güven çubukları ve daraltılabilir akıl yürütme ile görüntülenmiş.

Duck Debate

Ordekkeler arasında yapılandırılmış çok turlu tartışma, tur-tur görüş, format rozeti, katılımcı listesi, daraltılabilir turlar ve sentez bölümü ile gösterilir.

Kullanım İstatistikleri

Özet kartları, genişletilebilir satırları olan sağlayıcı dökümü, token dağılımı çubukları ve tahmini maliyetler ile kullanım analitikleri.

Mevcut Araçlar

Araç	Açıklama
ask_duck	Belirli bir LLM sağlayıcısına tek bir soru sorun
chat_with_duck	Bağlam mesajlar arasında korunan konuşma
clear_conversations	Tüm konuşma geçmişini temizle
list_ducks	Yapılandırılmış sağlayıcıları ve sağlık durumunu listele
list_models	Sağlayıcılar için mevcut modelleri listele
compare_ducks	Aynı soruyu birden fazla sağlayıcıya eş zamanlı olarak sorun
duck_council	Tüm yapılandırılmış ordekkelerden yanıt alın
get_usage_stats	Kullanım istatistikleri ve tahmini maliyetler
duck_vote	Akıl yürütme ve güven ile çok-ordekli oylama
duck_judge	Bir ordek'in diğerlerinin yanıtlarını değerlendirmesini sağlayın
duck_iterate	İki ordek arasında yanıtı yinelemeli olarak iyileştirin
duck_debate	Ordekkeler arasında yapılandırılmış çok-tur tartışma
mcp_status	MCP Bridge durumu ve bağlı sunucular
get_pending_approvals	MCP tool onayı bekleyen istekler
approve_mcp_request	Ordek'in MCP tool isteğini onayla veya reddet

Giriş şemaları ile tam referans: Tools docs

Mevcut Promptlar

Prompt	Amaç	Gerekli Bağımsız Değişkenler
perspectives	Atanmış merceğe sahip çok açılı analiz	problem, perspectives
assumptions	Planların içindeki gizli varsayımları ortaya çıkar	plan
blindspots	Göz ardı edilen riskleri ve boşlukları avla	proposal
tradeoffs	Yapılandırılmış seçenek karşılaştırması	options, criteria
red_team	Birden fazla açıdan güvenlik/risk analizi	target
reframe	Farklı seviyelerde sorun çerçevelemesi	problem
architecture	Kaygılar arasında tasarım incelemesi	design, workloads, priorities
diverge_converge	Farklı keşif ardından yakınsama	challenge

Örnekler ile tam referans: Prompts docs

Geliştirme

npm run dev        # Watch modu ile geliştirme
npm test           # Tüm testleri çalıştır
npm run lint       # ESLint
npm run typecheck  # Emit olmadan type kontrol

Dokümantasyon

Konu	Link
Kurulum rehberi (tüm araçlar)	docs/setup.md
Tam yapılandırma referansı	docs/configuration.md
Claude Desktop kurulumu	docs/claude-desktop.md
Şemalar ile tüm araçlar	docs/tools.md
Prompt şablonları	docs/prompts.md
CLI kodlama aracıları	docs/cli-providers.md
MCP Bridge	docs/mcp-bridge.md
Guardrails	docs/guardrails.md
Docker dağıtımı	docs/docker.md
Sağlayıcıya özel kurulum	docs/provider-setup.md
Kullanım örnekleri	docs/usage-examples.md
Mimari	docs/architecture.md
Yol Haritası	docs/roadmap.md

Sorun Giderme

Sağlayıcı Çalışmıyor

1. API anahtarının doğru ayarlandığını kontrol edin
2. Endpoint URL'sinin doğru olduğunu doğrulayın
3. Sağlık kontrolü çalıştırın: list_ducks({ check_health: true })
4. Ayrıntılı hata mesajları için logları kontrol edin

Bağlantı Sorunları

• Yerel sağlayıcılar (Ollama, LM Studio) için, çalıştığından emin olun
• Yerel endpoint'ler için güvenlik duvarı ayarlarını kontrol edin
• Bulut sağlayıcılarına ağ bağlantısını doğrulayın

Rate Limiting

• Alternatif sağlayıcılara failover yapılandırın
• max_retries ve timeout ayarlarını ayarlayın
• Rate limiting yapılandırması için Guardrails'e bakın

Katkıda Bulunma

     __
   <(o )___
    ( ._> /
     `---'  Quack! Hata ayıklamaya hazır!

Katkıları seviyoruz! Hataları düzenliyorsanız, özellik ekleniyorsanız veya ordekkelerimize yeni hileler öğreniyorsanız, sürüye katılmanızı severdik.

Başlamak için Katkı Rehberi'ne göz atın.

Katkıda bulunanlar için hızlı başlangıç:

1. Depoyu fork edin
2. Bir feature şubesi oluşturun
3. Geleneksel commit yönergelerini izleyin
4. Yeni işlevsellik için testler ekleyin
5. Pull request gönderin

Lisans

MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın

Teşekkürler

• Rubber duck debugging yöntemi tarafından ilham alınmıştır
• Model Context Protocol (MCP) üzerine inşa edilmiştir
• HTTP sağlayıcı uyumluluğu için OpenAI SDK kullanır
• CLI kodlama aracılarını destekler (Claude Code, Codex, Gemini CLI, Grok, Aider)

Değişiklik Günlüğü

Değişiklik ve sürümlerin ayrıntılı geçmişi için CHANGELOG.md'ye bakın.

Kayıt ve Dizin

• NPM Paketi: npmjs.com/package/mcp-rubber-duck
• Docker İmajları: ghcr.io/nesquikm/mcp-rubber-duck
• MCP Registry: Official MCP sunucusu io.github.nesquikm/rubber-duck
• Glama Dizini: glama.ai/mcp/servers/@nesquikm/mcp-rubber-duck
• Awesome MCP Servers: Topluluk dizininde listelendi

Destek

• Sorunları bildir: https://github.com/nesquikm/mcp-rubber-duck/issues
• Dokümantasyon: https://github.com/nesquikm/mcp-rubber-duck/wiki
• Tartışmalar: https://github.com/nesquikm/mcp-rubber-duck/discussions

---

AI Duck Paneliniz ile Mutlu Hata Ayıklamalar!